]> Cypherpunks repositories - gostls13.git/commit
syscall: document NewCallback and NewCallbackCDecl limitations
authorMichael Anthony Knyszek <mknyszek@google.com>
Wed, 19 May 2021 15:46:44 +0000 (15:46 +0000)
committerMichael Knyszek <mknyszek@google.com>
Thu, 20 May 2021 13:19:43 +0000 (13:19 +0000)
commitf07e4dae3c5cb608b4f0b9db57d1562d2125243b
treee90da458df9f7a487203a254e472286842b6afb9
parenta8d85918b63d481a414ec5ca3978d07b2b047363
syscall: document NewCallback and NewCallbackCDecl limitations

Currently NewCallback and NewCallbackCDecl may only be called a limited
number of times in a single Go process, but this property of the API is
not documented. This change fixes that, but does not document the
precise limit to avoid making that limit part of the API, leaving us
open to increasing or decreasing the limit in the future as needed.

Although the API avoids documenting a limit, it does guarantee a minimum
callback count so users can rely on at least some amount of callbacks
working.

Updates #46184.

Change-Id: I5129bf5fe301efff73ac112ba1f207ab32058833
Reviewed-on: https://go-review.googlesource.com/c/go/+/321133
Trust: Michael Knyszek <mknyszek@google.com>
Reviewed-by: Ian Lance Taylor <iant@golang.org>
src/syscall/syscall_windows.go