SYNTHCAPS 構造体 (dmusprop.h)

[アーティクル]
08/07/2023

SYNTHCAPS 構造体は、シンセサイザーの機能を指定します。

構文

typedef struct _SYNTHCAPS {
  GUID  Guid;
  DWORD Flags;
  DWORD MemorySize;
  DWORD MaxChannelGroups;
  DWORD MaxVoices;
  DWORD MaxAudioChannels;
  DWORD EffectFlags;
  WCHAR Description[128];
} SYNTHCAPS, *PSYNTHCAPS;

メンバーズ

Guid

シンセサイザーのミニポートドライバーインターフェイスのクラス ID を指定します。

Flags

ドライバーの一般的な機能を指定します。このメンバーは、値が 0 または次のフラグビットの 1 つ以上のビットごとの OR であるビットフィールドです。

SYNTH_PC_DLS

ドライバーは、ダウンロード可能なサンプルコレクション (DLS レベル 1) をサポートしています。

SYNTH_PC_EXTERNAL

シンセは、外部ハードウェアへの接続を表します。

SYNTH_PC_SOFTWARESYNTH

ドライバーは、ソフトウェアシンセサイザーを実装します。

SYNTH_PC_MEMORYSIZEFIXED

MemorySize メンバーに指定されたメモリサイズは有効であり、サンプルメモリの最大量 (バイト単位) を表します。通常、このフラグは、サンプルメモリがシステムメモリでない場合に設定されます。

SYNTH_PC_GMINHARDWARE

シンセは、ハードウェアに設定された一般的なMIDIサウンドをサポートしています。

SYNTH_PC_GSINHARDWARE

シンセは、ハードウェアでローランドGSサウンドセットをサポートしています。

SYNTH_PC_REVERB

シンセはリバーブをサポートしています。

SYNTH_PC_DLS2

ドライバーは、ダウンロード可能なサンプルコレクション (DLS レベル 2) をサポートしています。

SYNTH_PC_SYSTEMMEMORY

シンセは、システムメモリを使用することができます。

MemorySize

デバイス上のサンプルメモリの量をバイト単位で指定します。このフィールドには、デバイスがサンプルメモリにシステムメモリを使用し、割り当てられたメモリの量に制限がない場合にSYNTH_PC_SYSTEMMEMORY値を含める必要があります。

MaxChannelGroups

このドライバーがサポートするチャネルグループの最大数を指定します。各チャネルグループは 16 個の MIDI チャンネルのセットを表し、DLS、GM、GS、XG、またはその他のモード情報を含む MIDI ハードウェアデバイスが保持するすべての状態に関連付けられています。ただし、DLS のダウンロードはドライバーごとに行われ、どのチャネルグループでも使用できます。これにより、同じ DLS サンプルの複数のコピー (チャネルグループごとに 1 つ) をダウンロードすることで、メモリの無駄を防ぐことができます。

MaxVoices

レンダリングデバイスがサポートする音声の最大数を指定します。プロパティハンドラーがこのメンバーの有効な番号を指定できない場合は、メンバーを (ULONG)-1 に設定する必要があります。

MaxAudioChannels

レンダリングデバイスがサポートするオーディオチャネルの最大数を指定します。プロパティハンドラーがこのメンバーの有効な番号を指定できない場合は、メンバーを (ULONG)-1 に設定する必要があります。

EffectFlags

レンダリングデバイスが生成できる効果を指定します。このメンバーは、値が 0 または次のフラグビットのビットごとの OR であるビットフィールドです。

SYNTH_EFFECT_REVERB

レンダリングデバイスはリバーブ効果を生成できます。

SYNTH_EFFECT_CHORUS

レンダリングデバイスは、コーラス効果を生成することができます。

SYNTH_EFFECT_DELAY

レンダリングデバイスでは、遅延効果が生じる可能性があります。

デバイスでこれらの機能がサポートされていない場合は、このメンバーを SYNTH_EFFECT_NONE (ゼロ) に設定します。

Description[128]

デバイスのテキストの説明が含まれています。このメンバーは、null で終わる文字列 ("Microsoft MPU-401" など) を含む WCHAR 配列です。

備考

KSPROPERTY_SYNTH_CAPS get-property 要求では、SYNTHCAPS 構造体を使用して、DMus ミニポートドライバーからシンセサイザーデバイスの機能を取得します。

SYNTH_CAPSは、Microsoft Windows SDK ドキュメントで説明されているDMUS_PORTCAPS構造に似ています。

Windows Driver Kit (WDK) の DMusUART サンプルドライバーでは、KSPROPERTY_SYNTH_CAPS プロパティハンドラーによって、SYNTHCAPS 構造体のメンバーが次の値に設定されます。

  SYNTHCAPS *caps = (SYNTHCAPS*)pRequest->Value;
  ...
  caps->Flags              = SYNTH_PC_EXTERNAL;
  caps->MemorySize         = 0;         
  caps->MaxChannelGroups   = 1;
  caps->MaxVoices          = 0xFFFFFFFF;  // (ULONG)-1
  caps->MaxAudioChannels   = 0xFFFFFFFF;  // (ULONG)-1
  caps->EffectFlags        = 0;

この例では、0xFFFFFFFF値は、ハンドラーが MaxVoices と MaxAudioChannels の実際の を知る方法がないことを示します。これは、外部シンセサイザーが UART に接続される場合に発生するあらゆる外部シンセサイザーに完全に依存するためです。コード内の他の場所では、前の例では示されていませんが、DMusUART プロパティハンドラーは、SYNTHCAPS 構造体の Guid メンバーを CLSID_MiniportDriverDMusUART または CLSID_MiniportDriverDMusUARTCaptureに設定します。 Guid メンバーが設定されているのは、プロパティ要求のターゲットノード (KSNODETYPE_SYNTHESIZER型) が、レンダリングデータを処理するデータパス上にあるか、データをキャプチャするかによって異なります。どちらのクラス ID もヘッダーファイル Dmusicks.h で定義されています。

必要条件

要件	価値
ヘッダー	dmusprop.h (Dmusprop.h を含む)

次の方法で共有