PUNREGISTER_EVENT_CALLBACK funzione di callback (hdaudio.h)

Articolo
02/07/2025

La routine UnregisterEventCallback elimina la registrazione di un callback di evento registrato in precedenza da una chiamata a RegisterEventCallback.

Il tipo di puntatore di funzione per una routine UnregisterEventCallback è definito come segue.

Sintassi

PUNREGISTER_EVENT_CALLBACK PunregisterEventCallback;

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

Parametri

[in] _context

Specifica il valore di contesto del membro Context della struttura HDAUDIO_BUS_INTERFACE, HDAUDIO_BUS_INTERFACE_V2o HDAUDIO_BUS_INTERFACE_BDL.

[in] Tag

Specifica il valore del tag associato al callback dalla chiamata precedente a RegisterEventCallback.

Valore restituito

unregisterEventCallback restituisce STATUS_SUCCESS se la chiamata riesce a modificare gli stati dei motori DMA. In caso contrario, la routine restituisce un codice di errore appropriato. Nella tabella seguente viene illustrato un possibile codice di stato restituito.

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Indica che il tag specificato non è valido.

Osservazioni

Prima di chiamare questa routine, il driver di funzione è responsabile della programmazione del codec o dei codec per rimuovere l'associazione del callback con il tag specificato.