PUNREGISTER_NOTIFICATION_CALLBACK コールバック関数 (hdaudio.h)
PUNREGISTER_NOTIFICATION_CALLBACKコールバック関数は、RegisterNotificationCallback の呼び出しによって以前に登録された通知コールバック ルーチンの登録を削除します。
構文
PUNREGISTER_NOTIFICATION_CALLBACK PunregisterNotificationCallback;
NTSTATUS PunregisterNotificationCallback(
PVOID _context,
HANDLE Handle,
PHDAUDIO_DMA_NOTIFICATION_CALLBACK NotificationCallback,
PVOID CallbackContext
)
{...}
パラメーター
_context
HDAUDIO_BUS_INTERFACE_V3構造体の Context メンバーからコンテキスト値を指定します。
Handle
DMA エンジンを識別するハンドル。 このハンドル値は、 AllocateCaptureDmaEngine または AllocateRenderDmaEngine の以前の呼び出しから取得されました。
NotificationCallback
PREGISTER_NOTIFICATION_CALLBACK の呼び出しで DMA 進行状況通知用に以前に登録されたコールバック ルーチン。
CallbackContext
コールバック ルーチンのドライバー固有のコンテキスト値。
戻り値
PUNREGISTER_NOTIFICATION_CALLBACKは、呼び出しによって通知イベントが正常に登録解除された場合にSTATUS_SUCCESSを返します。 それ以外の場合、ルーチンは、指定されたコールバック ルーチンとコンテキストが無効であることを示すSTATUS_INVALID_PARAMETERを返します。
詳細については、「 NTSTATUS 値」を参照してください。
注釈
PUNREGISTER_NOTIFICATION_CALLBACKでは、NotificationCallback と CallbackContext の両方を使用して、削除する以前に登録された一致するコールバック ルーチンを検索します。
HD Audio バス ドライバーは、通知コールバック ルーチンが以前に登録されたときにドライバー FDO で取得した参照を解放します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | 19H1 |
| Header | hdaudio.h |
| IRQL | PASSIVE_LEVEL |