KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT プロパティは、DMA 駆動イベント通知からユーザー モード イベントの登録を解除します。

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

用法の要点テーブル

Yammer の入手	設定	移行先	プロパティ記述子の種類	プロパティ値の種類
はい	はい	ピン留めする	KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY	NULL

プロパティ記述子 (インスタンス データ) は、KSPROPERTY 構造体とユーザー モード イベント ハンドルを含む KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY 構造体で構成されます。

操作データが返されないため、このプロパティのプロパティ値 (操作データ) は NULL です。

戻り値

KSPROPERTY_ RTAUDIO_UNREGISTER_NOTIFICATION_EVENT プロパティ要求は、正常に完了したことを示す STATUS_SUCCESS を返します。 それ以外の場合、要求は適切な失敗状態コードを返します。 次の表に、考えられる失敗状態コードの一部を示します。

状態コード	意味
STATUS_NOT_SUPPORTED	イベント通知はサポートされません。
STATUS_INSUFFICIENT_RESOURCES	割り当て不可のバッファーのメモリ。
STATUS_DEVICE_NOT_READY	デバイスの準備ができていません。

解説

このプロパティは、DMA 駆動イベント通知からユーザー モード イベントの登録を解除するために使用されます。

ピンが実行状態 (KSSTATE_RUN) になると、登録されたイベントは、KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION が呼び出されたときに要求された通知数に応じて、循環オーディオ バッファーのサイクルごとに 1 回または 2 回通知されます。 KSSTATE_RUN の詳細については、「状態遷移」トピックを参照してください。

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

要件

バージョン	Windows Vista 以降の Windows オペレーティング システムで使用できます。
ヘッダー	Ksmedia.h

関連項目

KSPROPERTY

KSRTAUDIO_NOTIFICATION_EVENT_PROPERTY

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT