PCNODE_DESCRIPTOR構造体 (portcls.h)

[アーティクル]
03/05/2024

PCNODE_DESCRIPTOR構造体は、トポロジミニポートドライバーが実装するフィルター内のノードを記述します。

構文

typedef struct {
  ULONG                    Flags;
  const PCAUTOMATION_TABLE *AutomationTable;
  const GUID               *Type;
  const GUID               *Name;
} PCNODE_DESCRIPTOR, *PPCNODE_DESCRIPTOR;

メンバー

Flags

0 に設定します。フラグビットは現在定義されていません。

AutomationTable

オートメーションテーブルへのポインター。これは、PCAUTOMATION_TABLE型の構造体です。このメンバーは NULL に設定して、オートメーションのサポートがないことを示すことができます。オートメーションテーブルは、ノードインスタンスに属するプロパティとイベントのハンドラーを指定します。

Type

ノードの種類を指定します。このメンバーは、ノードの種類を一意に識別する GUID へのポインターです。「オーディオトポロジノード」のノードタイプ GUID の一覧を参照してください。

Name

このトポロジノードの名前を表す GUID へのポインター。この GUID は、 KSPROPERTY_TOPOLOGY_NAMEget-property 要求で指定され、ノードの対応する名前文字列を取得します。このポインターを NULL に設定すると、 Type メンバーの GUID を使用してノード名を決定する必要があることを示すことができます。

注釈

フィルターに Type メンバーで指定された型のノードが 1 つだけ含まれている場合、Type 値がフィルター内のノードを一意に識別するのに十分であるため、Name メンバーを NULL として指定できます。フィルターに同じ種類のノードが 2 つ以上含まれている場合、それらのノードの Name メンバーは NULL 以外である必要があります。

たとえば、フィルターに 1 つの SUM ノードが含まれている場合、そのノードの Type メンバーは GUID 値 KSNODETYPE_SUMを指し、 Name メンバーは NULL に設定されます。そのノードの名前を照会すると、 KSPROPERTY_TOPOLOGY_NAME プロパティは、ノードの Name 値が NULL であることを確認した後、KSNODETYPE_SUM GUID のレジストリエントリから名前文字列を取得します。ただし、同じフィルターに複数のボリュームノードが含まれている場合があります。この場合、これらのノードの Type 値はすべて同じ GUID 値 KSNODETYPE_VOLUMEを指し、 Name 値は各ボリュームノードを一意に識別する必要があります。たとえば、ウェーブ入力ボリューム制御ノードの Name 値は、GUID 値 KSAUDFNAME_WAVE_IN_VOLUME (ksmedia.h で定義) をポイントする必要があります。この GUID のレジストリエントリには、KSPROPERTY_TOPOLOGY_NAME プロパティがノードに対して取得する名前文字列が含まれています。