SYSAUDIO_INSTANCE_INFO構造体 (ksmedia.h)

[アーティクル]
02/29/2024

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

デバイス ID を指定します。このメンバーは、プロパティ要求によって開かれる仮想オーディオデバイスを識別します。 SysAudio が N 個 の仮想オーディオデバイスを列挙する場合 ( KSPROPERTY_SYSAUDIO_DEVICE_COUNT参照)、有効なデバイス ID の範囲は 0 から N-1 です。

注釈

この構造体は、 KSPROPERTY_SYSAUDIO_INSTANCE_INFO プロパティによって使用されます。

既定では、仮想オーディオデバイスは、そのウェーブレンダリングピンを組み合わせます。 SYSAUDIO_FLAGS_DONT_COMBINE_PINS フラグは、この既定値をオーバーライドします。

ピンを組み合わせると、仮想オーディオデバイスは、オーディオデバイス上のハードウェアアクセラレータレンダリングピンと KMixer システムドライバー上のソフトウェアエミュレートされたミキサーピンを組み合わせた単一のピンファクトリを公開します。ピンが組み合わされていない場合、ハードウェアアクセラレータピンとソフトウェアエミュレートピンは、別々のピンファクトリを介して公開されます。ハードウェアアクセラレータピンの数をアプリケーションプログラムに正しく報告するために、DirectSound ではピンを組み合わせないようにする必要があります。

このプロパティは KSPROPERTY_SYSAUDIO_DEVICE_INSTANCEに似ていますが、仮想オーディオデバイスの構成方法を指定するフラグが含まれている点が例外です。