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 用來取消註冊事件。

規格需求

另請參閱

KSPROPERTY

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT