Skip to main content

XTaskQueueSubmitDelayedCallback

Envía una devolución de llamada a la cola para el puerto especificado.

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. delayMs   _In_
Tipo: uint32_t
El número de milisegundos de retraso antes de enviar la devolución de llamada a la cola.
Se puede enviar una devolución de llamada para que se agregue a la cola en algún momento futuro. Si delayMs es distinto de cero, la devolución de llamada se colocará en una lista de pendientes y se inicializará un temporizador con el tiempo de espera más próximo. Cuando transcurra ese tiempo, la devolución de llamada con el siguiente tiempo se colocará en la lista de ejecución. La cola generará una XTaskQueueMonitorCallback y, si la cola se ejecuta en un modo de distribución de grupo de subprocesos, se enviará trabajo al grupo de subprocesos.
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.

Valor devuelto

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

Comentarios

Esta devolución de llamada se agregará a la cola después de delayMs milisegundos. alerta Nota de rendimiento:
Agregar un elemento a una cola debe ser una operación sin bloqueos ni esperas para satisfacer los requisitos de rendimiento del código de niveles superiores. Las siguientes API no usan bloqueos:
En el ejemplo siguiente se permite enviar devoluciones de llamada en el futuro mediante la función XTaskQueueSubmitDelayedCallback. Esta es una excelente manera de reintentar una llamada con error después de un breve retraso; también se puede usar como un temporizador económico para eventos periódicos.
SubmitCallback es una función auxiliar que se define en el ejemplo de código de la función XTaskQueueSubmitCallback.

Requisitos

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

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