SYSAUDIO_INSTANCE_INFO 結構 (ksmedia.h)

SYSAUDIO_INSTANCE_INFO 結構會指定要開啟的虛擬音訊裝置,並包含設定該裝置的旗標。

語法

typedef struct {
  KSPROPERTY Property;
  ULONG      Flags;
  ULONG      DeviceNumber;
} SYSAUDIO_INSTANCE_INFO, *PSYSAUDIO_INSTANCE_INFO;

成員

Property

指定屬性。 此參數是 KSPROPERTY 類型的結構。

Flags

指定如何設定虛擬音訊裝置的旗標。 目前,為此參數定義的唯一旗標位是SYSAUDIO_FLAGS_DONT_COMBINE_PINS。 如果設定,這個旗標位會指示 SysAudio 不要結合轉譯釘選。 如需詳細資訊,請參閱接下來的<備註>一節。

DeviceNumber

指定裝置識別碼。 這個成員會識別屬性要求所要開啟的虛擬音訊設備。 如果 SysAudio 列舉 N 個虛擬音訊裝置, (請參閱 KSPROPERTY_SYSAUDIO_DEVICE_COUNT) ,則有效的裝置識別碼範圍從 0 到 N-1

備註

這個結構是由 KSPROPERTY_SYSAUDIO_INSTANCE_INFO 屬性使用。

根據預設,虛擬音訊設備會結合其波浪轉譯針腳。 SYSAUDIO_FLAGS_DONT_COMBINE_PINS旗標會覆寫此預設值。

結合針腳時,虛擬音訊裝置會公開單一針腳處理站,結合音訊裝置上的硬體加速轉譯針腳與 KMixer 系統驅動程式上的軟體模擬混音器針腳。 如果未結合針腳,則會透過個別的針腳處理站公開硬體加速針腳和軟體模擬針腳。 為了正確地向應用程式報告硬體加速針腳數目,DirectSound 會要求不會合併針腳。

此屬性類似於 KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE,但例外狀況是它包含指定如何設定虛擬音訊裝置的旗標。

規格需求

需求
標頭 ksmedia.h (包含 Ksmedia.h)

另請參閱

KSPROPERTY

KSPROPERTY_SYSAUDIO_DEVICE_COUNT

KSPROPERTY_SYSAUDIO_DEVICE_INSTANCE

KSPROPERTY_SYSAUDIO_INSTANCE_INFO