KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION構造体は、KSPROPERTY 構造体にバッファー ベース アドレス、要求されたバッファー サイズ、および通知カウントを追加します。 この構造体は、KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION経由でオーディオ バッファーの割り当てを要求するためにクライアントによって使用されます。
構文
typedef struct {
KSPROPERTY Property;
PVOID BaseAddress;
ULONG RequestedBufferSize;
ULONG NotificationCount;
} KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION, *PKSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION;
メンバーズ
Property
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATIONを呼び出す前にクライアントが適切に初期化する KSPROPERTY 構造体。
BaseAddress
バッファーのベース アドレスを指定します。 クライアントがベース アドレスを指定しない限り、このパラメーターは null に設定されます。
RequestedBufferSize
バッファー サイズをバイト単位で指定します。 ドライバーは、返される KSRTAUDIO_BUFFER 構造体で割り当てられたバッファーの実際のサイズを返します。
NotificationCount
循環バッファーのサイクルあたりの通知の数を指定します。 現在、有効な値は 1 または 2 です。 値が 1 の場合、環状バッファーの末尾に登録された通知イベントに通知されます。 値が 2 の場合、循環バッファーの中間点と末尾の両方で通知が行われます。
備考
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION要求では、KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION構造体を使用して、クライアントが要求する循環バッファーを記述します。 ドライバーは、実際に割り当てられたバッファーを記述するKSRTAUDIO_BUFFER構造体を返します。
KSPROPERTY_RTAUDIO_BUFFERと同様に、クライアントが RequestedBufferSize メンバーに書き込む値は、ドライバーでバインドされません。
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATIONを使用すると、DMA が循環バッファーを介して進行するにつれて、イベント シグナル通知が容易になります。 KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT は、これらの通知を受信するイベントを登録するために使用され、KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT を使用してイベントの登録を解除します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降の Windows オペレーティング システムで使用できます。 |
| ヘッダー | ksmedia.h |
関連項目
KSPROPERTY を する
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION