KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT
KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT 屬性會註冊 DMA 驅動事件通知的使用者模式事件。 成功呼叫 KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION之後，必須註冊事件。
下表摘要說明此屬性的功能。
使用量摘要資料表
| Get | 集合 | 目標 | 屬性描述項類型 | 屬性值類型 |
|---|---|---|---|---|
是 |
是 |
Pin |
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 |
另請參閱
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION