Skip to main content

XTaskQueueRegisterWaiter

Registra un identificador de espera con una cola de tareas.

Sintaxis

Parámetros

queue   _In_
Tipo: XTaskQueueHandle
La cola a la que se enviará la devolución de llamada. port   _In_
Tipo: XTaskQueuePort
El puerto al que se enviará la devolución de llamada. Las devoluciones de llamada se pueden asignar a los puertos de trabajo o de finalización. waitHandle   _In_
Tipo: HANDLE
El identificador que se supervisará.
Este es el identificador de espera que, cuando se señala, hace que se invoque la devolución de llamada. El identificador de espera suele ser un evento de restablecimiento automático o manual. Si el identificador de espera es de restablecimiento manual, la devolución de llamada se invocará repetidamente mientras el evento esté señalado. Si esto no es lo que quiere, restablezca el evento dentro de la devolución de llamada o anule el registro de la devolución de llamada de espera.
callbackContext   _In_opt_
Tipo: void*
Un puntero de contexto opcional que se pasará a la devolución de llamada. callback   _In_
Tipo: XTaskQueueCallback*
Un puntero a la función de devolución de llamada. token   _Out_
Tipo: XTaskQueueRegistrationToken*
Un token de registro. Se puede pasar a XTaskQueueUnregisterWaiter para anular el registro de la espera.

Valor devuelto

Tipo: HRESULT Código de error o de éxito HRESULT.

Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
Cuando se satisface el identificador de espera, la cola de tareas invoca la devolución de llamada especificada. Esto proporciona una manera eficaz de agregar elementos a una cola de tareas en respuesta a identificadores que se señalan. En el ejemplo siguiente se registra un identificador de kernel Win32 con una cola de tareas. La devolución de llamada se enviará a la cola cuando el identificador se señale. Normalmente, crearía un evento de restablecimiento automático para usarlo en la señalización. Si el identificador no es de restablecimiento automático, se enviará una nueva devolución de llamada cuando se complete la devolución de llamada actual, mientras el identificador siga señalado.

Requisitos

Encabezado: XTaskQueue.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

Miembros de XTaskQueue
Modelo de programación asincrónica
Diseño de la cola de tareas asincrónicas
Última modificación el 28 de agosto de 2026