IMiniportWaveRTStreamNotification：：RegisterNotificationEvent 方法 (portcls.h)

方法 RegisterNotificationEvent 會註冊要通知 DMA 驅動事件通知的事件。

語法

NTSTATUS RegisterNotificationEvent(
  [in] PKEVENT NotificationEvent
);

參數

[in] NotificationEvent

要註冊通知為 DMA 的 PKEVENT (PKEVENT) 指標。

傳回值

RegisterNotificationEvent 如果呼叫成功，則會傳回狀態值STATUS_SUCCESS。 否則，方法會傳回適當的錯誤狀態代碼。

備註

埠驅動程式會呼叫這個方法，以回應用戶端的 KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT 屬性要求。 埠驅動程式會將使用者模式事件句柄對應至核心事件指標，並使用 NotificationEvent 參數將指標傳入。

一般而言，啟用 DMA 驅動事件通知時，DMA 硬體會設計為在迴圈音訊緩衝區中預期的通知點產生硬體中斷。 當驅動程式中斷服務例程 (ISR) 偵測到此中斷時，它會將延遲過程調用排入佇列 (DPC) 。 DPC 接著會發出每個已註冊事件的訊號。 我們建議在發出呼叫訊號的事件周圍使用 try/except 建構。

如需KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT屬性行為的詳細資訊，請參閱 KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY。

規格需求

另請參閱

IMiniportWaveRTStreamNotification

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY