共用方式為


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

KSPROPERTY_RTAUDIO_BUFFER_WITH_NOTIFICATION

KSPROPERTY_RTAUDIO_REGISTER_NOTIFICATION_EVENT

KSPROPERTY_RTAUDIO_UNREGISTER_NOTIFICATION_EVENT