Skip to main content

​
XTaskQueueUnregisterMonitor

Cancela o registro de um retorno de chamada de monitor registrado anteriormente.

​
Sintaxe

​
Parâmetros

queue   _In_
Tipo: XTaskQueueHandle A fila da qual remover o retorno de chamada de envio. token   _In_
Tipo: XTaskQueueRegistrationToken O token de registro retornado por XTaskQueueRegisterMonitor.

​
Valor retornado

Tipo: void

​
Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Se XTaskQueueRegisterMonitor tiver sido invocado anteriormente para registrar um retorno de chamada XTaskQueueMonitorCallback para uma fila de tarefas, use XTaskQueueUnregisterMonitor para cancelar o registro do retorno de chamada. Depois que o registro é cancelado, o retorno de chamada não é mais invocado quando tarefas são enviadas para execução na fila de tarefas. Cancelar o registro do retorno de chamada também libera a referência dele ao identificador da fila de tarefas.
Se você chamar XTaskQueueRegisterMonitor para registrar um retorno de chamada XTaskQueueMonitorCallback em uma fila de tarefas, deverá usar XTaskQueueUnregisterMonitor para cancelar o registro do retorno de chamada antes de fechar o identificador da fila de tarefas com XTaskQueueCloseHandle; caso contrário, poderá ocorrer um vazamento de memória. Um identificador de fila de tarefas é um recurso compartilhável e só é realmente destruído quando todas as referências a esse identificador são liberadas. Para obter mais informações, consulte Design da fila de tarefas assíncrona.

​
Requisitos

Cabeçalho: XTaskQueue.h Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

​
Documentação conceitual

​
Confira também

XTaskQueueRegisterMonitor
XTaskQueueMonitorCallback
Membros de XTaskQueue
Modelo de programação assíncrona
Design da fila de tarefas assíncrona
Last modified on October 6, 2026