Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Describes the desired device enumeration behavior of a newly registered LampArrayStatusCallback function. Used with RegisterLampArrayStatusCallback, this behavior will apply only to LampArrays that are connected at the time of the registration.
Syntax
enum class LampArrayEnumerationKind : uint32_t
{
Async = 1,
Blocking = 2
};
Constants
| Constant | Description |
|---|---|
| Async | The call to RegisterLampArrayStatusCallback should return immediately, and enumeration of connected LampArrays should occur asynchronously on the dedicated LampArray callback worker thread. |
| Blocking | The call to RegisterLampArrayStatusCallback should block until all connected LampArrays have been enumerated. |
Remarks
The LampArrayEnumerationKind parameter of RegisterLampArrayStatusCallback allows the caller to specify how it should receive callbacks for any LampArray devices that are attached at the time of the call. If LampArrayEnumerationKind::Blocking is selected, the RegisterLampArrayStatusCallback function will block until that callback is invoked for each attached device (meaning the callback will be invoked on the calling thread).
When the first callback is registered, the LampArray API starts a worker thread to handle ILampArray device status notifications. These events are infrequent, and the worker thread otherwise remains in a wait state. After the registration call returns, all subsequent LampArrayStatusCallbacks will be invoked sequentially on this worker thread.
If LampArrayEnumerationKind::Async is specified, the registration call will return immediately, and any LampArrays connected at the time of the call will be enumerated on the aforementioned LampArray callback worker thread.
Requirements
Header: Declared in LampArray.h.