KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT 屬性會註冊 DMA 驅動事件通知的使用者模式事件。成功呼叫 KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION之後，必須註冊事件。

下表摘要說明此屬性的功能。

Get	集合	目標	屬性描述項類型	屬性值類型
是	是	Pin	KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY	NULL

屬性描述項 (實例資料) 是由包含 KSPROPERTY 結構以及使用者模式事件控制碼的KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY結構所組成。

此屬性的屬性值 (作業資料) 為 Null ，因為不會傳回任何作業資料。

KSPROPERTY_ RTAUDIO_REGISTER_NOTIFICATION_EVENT屬性要求會傳回STATUS_SUCCESS，表示它已順利完成。否則，要求會傳回適當的失敗狀態碼。下表顯示一些可能的失敗狀態碼。

狀態碼	意義
STATUS_NOT_SUPPORTED	不支援事件通知。
STATUS_INSUFFICIENT_RESOURCES	無法配置緩衝區的記憶體。
STATUS_DEVICE_NOT_READY	裝置未就緒。

備註

這個屬性是用來註冊 DMA 驅動事件通知的使用者模式事件。

當針腳進入執行狀態時， (KSSTATE_RUN) 每個迴圈迴圈的迴圈音訊緩衝區發出一次或兩次的訊號，視呼叫KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION時所要求的通知計數而定。如需 KSSTATERUN 的詳細資訊，請參閱狀態轉換主題。

在您停止釘選之後，並在關閉釘選之前，會透過呼叫取消註冊每個已註冊的事件 KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT。

版本	可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
標頭	Ksmedia.h