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。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
目標平台 | Universal |
標頭 | portcls.h |
IRQL | 被動層級。 |
另請參閱
IMiniportWaveRTStreamNotification