PREGISTER_NOTIFICATION_EVENT回呼函式 (hdaudio.h)

發行項
02/26/2024

RegisterNotificationEvent 例程會註冊核心事件，以便接收 DMA 進度通知。

RegisterNotificationEvent 例程的函式指標類型定義如下。

語法

PREGISTER_NOTIFICATION_EVENT PregisterNotificationEvent;

NTSTATUS PregisterNotificationEvent(
  [in] PVOID _context,
  [in] HANDLE Handle,
  [in] PKEVENT NotificationEvent
)
{...}

參數

[in] _context

指定 HDAUDIO_BUS_INTERFACE_V2 結構之 Context 成員的內容值。

[in] Handle

識別 DMA 引擎的句柄。這個句柄值是從先前呼叫 AllocateCaptureDmaEngine 或 AllocateRenderDmaEngine 取得。

[in] NotificationEvent

核心事件的指標，必須在 DMA 進行時收到通知。根據與 AllocateDmaBufferWithNotification 搭配使用的通知計數參數而定，每次 DMA 通過音頻緩衝區時，已註冊的事件都會發出一或兩次的訊號。

傳回值

如果呼叫成功註冊事件，RegisterNotificationEvent 會傳回STATUS_SUCCESS。否則，例程會傳回STATUS_INSUFFICIENT_RESOURCES，表示沒有足夠的資源可用來完成作業。

備註

RegisterNotificationEvent 向 HD 音訊總線驅動程式註冊核心事件。 HD 音訊總線驅動程式會針對每個 DMA 引擎維護已註冊的通知事件清單，並在每次引擎收到 IOC 中斷時發出訊號。事件會使用 UnregisterNotificationEvent 取消註冊。

規格需求

需求	值
最低支援的用戶端	可在 Windows Vista 和更新版本的 Windows 中使用。
目標平台	桌面
標頭	hdaudio.h (包含 Hdaudio.h)
IRQL	PASSIVE_LEVEL