Skip to main content

XTaskQueueGetPort

Devuelve el identificador del puerto de la cola de tareas para el puerto especificado.

Sintaxis

Parámetros

queue   _In_
Tipo: XTaskQueueHandle
La cola de tareas de la que se obtendrá el puerto. port   _In_
Tipo: XTaskQueuePort
El puerto que se obtendrá. portHandle   _Out_
Tipo: XTaskQueuePortHandle*
El identificador del puerto de la cola de tareas para el puerto especificado.

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.
Los identificadores de puerto de la cola de tareas pertenecen a la cola de tareas y no es necesario cerrarlos. Se usan al crear colas de tareas compuestas. En el ejemplo siguiente se crea una cola compuesta cuyos puertos de trabajo y de finalización usan ambos el puerto de trabajo de la cola original. Una cola de tareas compuesta es una cola de tareas que se compone de partes de otras colas. Las colas de tareas compuestas son útiles cuando una tarea asincrónica necesita llamar a otra, y la finalización de esa tarea es un paso intermedio que no debería desperdiciar ciclos en el subproceso de finalización.
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

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