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 作業系統中使用。 |
| 標頭 | ksmedia.h |
另請參閱
KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION