XTaskQueueTerminate
Finaliza una cola de tareas cancelando todos los elementos pendientes e impidiendo que se pongan en cola nuevos elementos.Sintaxis
Parámetros
queue _In_Tipo: XTaskQueueHandle La cola que se finalizará. wait _In_
Tipo: bool True para esperar a que se complete la finalización. callbackContext _In_opt_
Tipo: void* Un puntero de contexto opcional que se pasará a la devolución de llamada. callback _In_opt_
Tipo: XTaskQueueTerminatedCallback* Una devolución de llamada opcional que se llamará cuando la cola haya finalizado.
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.
- Todas las devoluciones de llamada de ambos puertos se invocarán con su parámetro canceled establecido en true.
- Se distribuirán todas las devoluciones de llamada pendientes en el puerto de trabajo. El envío de nuevas devoluciones de llamada al puerto de trabajo producirá un error E_ABORT.
- Se distribuirán todas las devoluciones de llamada pendientes en el puerto de finalización. El envío de nuevas devoluciones de llamada al puerto de finalización producirá un error E_ABORT.
- XTaskQueueTerminate no cierra el identificador de la cola. Después de finalizar, todavía debe llamar a XTaskQueueCloseHandle.
- Si llama a XTaskQueueTerminate en un subproceso que está atendiendo devoluciones de llamada de la cola mediante llamadas a XTaskQueueDispatch, no pase true para el parámetro wait o el código podría interbloquearse.
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 SeriesDocumentación conceptual
Consulte también
Miembros de XTaskQueueModelo de programación asincrónica
Diseño de la cola de tareas asincrónicas
