KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT
KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT プロパティは、DMA 駆動イベント通知からユーザー モード イベントを登録します。 イベントは、KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION を正常に呼び出した後に登録する必要があります。
次の表は、このプロパティの機能をまとめたものです。
用法の要点テーブル
| Yammer の入手 | 設定 | 移行先 | プロパティ記述子の種類 | プロパティ値の種類 |
|---|---|---|---|---|
はい |
はい |
ピン留めする |
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 が呼び出されたときに要求された通知数に応じて、循環オーディオ バッファーのサイクルごとに 1 回または 2 回通知されます。 KSSTATERUN の詳細については、「状態遷移」トピックを参照してください。
ピンを停止した後、ピンを閉じる時間の前に、登録された各イベントは、KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT の呼び出しを介して登録解除する必要があります。
要件
バージョン |
Windows Vista 以降の Windows オペレーティング システムで使用できます。 |
ヘッダー |
Ksmedia.h |
関連項目
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION