次の方法で共有


KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT プロパティは、DMA 駆動イベント通知からユーザー モード イベントを登録します。 イベントは、KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION を正常に呼び出した後に登録する必要があります。

次の表は、このプロパティの機能をまとめたものです。

用法の要点テーブル

Yammer の入手 設定 移行先 プロパティ記述子の種類 プロパティ値の種類

はい

はい

ピン留めする

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 が呼び出されたときに要求された通知数に応じて、循環オーディオ バッファーのサイクルごとに 1 回または 2 回通知されます。 KSSTATERUN の詳細については、「状態遷移」トピックを参照してください。

ピンを停止した後、ピンを閉じる時間の前に、登録された各イベントは、KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT の呼び出しを介して登録解除する必要があります。

要件

バージョン

Windows Vista 以降の Windows オペレーティング システムで使用できます。

ヘッダー

Ksmedia.h

関連項目

KSPROPERTY

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT

状態遷移