KSRTAUDIO_BUFFER_PROPERTY_WITH_NOTIFICATION構造体 (ksmedia.h)
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 オペレーティング システムで使用できます。 |
| Header | ksmedia.h |
こちらもご覧ください
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION