PUNREGISTER_EVENT_CALLBACK função de retorno de chamada (hdaudio.h)

Artigo
02/07/2025

A rotina UnregisterEventCallback exclui o registro de um retorno de chamada de evento que foi registrado anteriormente por uma chamada para RegisterEventCallback.

O tipo de ponteiro de função de uma rotina UnregisterEventCallback é definido da seguinte maneira.

Sintaxe

PUNREGISTER_EVENT_CALLBACK PunregisterEventCallback;

NTSTATUS PunregisterEventCallback(
  [in] PVOID _context,
  [in] UCHAR Tag
)
{...}

Parâmetros

[in] _context

Especifica o valor de contexto do de contexto membro da estrutura HDAUDIO_BUS_INTERFACE, HDAUDIO_BUS_INTERFACE_V2ou HDAUDIO_BUS_INTERFACE_BDL.

[in] Tag

Especifica o valor da marca que foi associado ao retorno de chamada pela chamada anterior para RegisterEventCallback .

Valor de retorno

UnregisterEventCallback retornará STATUS_SUCCESS se a chamada tiver êxito em alterar os estados dos mecanismos de DMA. Caso contrário, a rotina retornará um código de erro apropriado. A tabela a seguir mostra um possível código de status de retorno.

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Indica que a marca especificada não é válida.

Observações

Antes de chamar essa rotina, o driver de função é responsável por programar o codec ou codecs para remover a associação do retorno de chamada com a marca especificada.