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
デバイス 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に似ていますが、仮想オーディオ デバイスの構成方法を指定するフラグが含まれている点が異なります。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | ksmedia.h (Ksmedia.h を含む) |
関連項目
KSPROPERTY を する
KSPROPERTY_SYSAUDIO_DEVICE_COUNT