Share via

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

こちらもご覧ください

PREGISTER_NOTIFICATION_CALLBACK

HDAUDIO_BUS_INTERFACE_V3

hdaudio.h