PCPROPERTY_REQUEST 構造体 (portcls.h)

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

PCPROPERTY_REQUEST構造体は、プロパティ要求を指定します。

構文

typedef struct _PCPROPERTY_REQUEST {
  PUNKNOWN              MajorTarget;
  PUNKNOWN              MinorTarget;
  ULONG                 Node;
  const PCPROPERTY_ITEM *PropertyItem;
  ULONG                 Verb;
  ULONG                 InstanceSize;
  PVOID                 Instance;
  ULONG                 ValueSize;
  PVOID                 Value;
  PIRP                  Irp;
} PCPROPERTY_REQUEST, *PPCPROPERTY_REQUEST;

メンバー

MajorTarget

メインミニポートオブジェクトへの IUnknown ポインター。このメンバーには、アダプタードライバーが以前に IPort::Init メソッドに渡した UnknownMiniport パラメーター値が含まれています。

MinorTarget

MajorTarget ミニポートオブジェクトに関連付けられているストリームオブジェクトへの IUnknown ポインター。プロパティ要求のターゲットがピンインスタンスの場合、このメンバーには、IMiniport Xxx::NewStream メソッドが以前にポートドライバーに出力したストリームオブジェクトポインターが含まれます (たとえば、IMiniportWaveCyclic::NewStream メソッドの Stream パラメーター)。それ以外の場合 (プロパティ要求のターゲットがフィルターインスタンスの場合)、このメンバーは NULL です。

Node

ノード ID を指定します。このメンバーは、要求のターゲットノードを識別します。ターゲットがノードでない場合、このメンバーは ULONG(-1) に設定されます。

PropertyItem

PCPROPERTY_ITEM 型の構造体であるプロパティ項目へのポインター。

Verb

プロパティ要求の種類を指定します。 Verb は、ヘッダーファイル ks.h から次のフラグビットの 1 つ以上のビットごとの OR に設定されます。

KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
KSPROPERTY_TYPE_SETSUPPORT
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_RELATIONS
KSPROPERTY_TYPE_SERIALIZESET
KSPROPERTY_TYPE_UNSERIALIZESET
KSPROPERTY_TYPE_SERIALIZERAW
KSPROPERTY_TYPE_UNSERIALIZERAW
KSPROPERTY_TYPE_SERIALIZESIZE
KSPROPERTY_TYPE_DEFAULTVALUES
KSPROPERTY_TYPE_TOPOLOGY

これらのフラグについては、 KSPROPERTY を参照してください。

InstanceSize

プロパティインスタンスバッファーのサイズをバイト単位で指定します。

Instance

プロパティインスタンスバッファーへのポインター

ValueSize

プロパティ値バッファーのサイズをバイト単位で指定します。

Value

プロパティ値バッファーへのポインター

Irp

クライアントの元のプロパティ要求を含む IRP へのポインター

注釈

これは、ポートドライバーがミニポートドライバーのプロパティハンドラールーチンに渡す構造です。 PCPROPERTY_ITEM構造体には、PCPROPERTY_REQUEST ポインターを唯一の呼び出しパラメーターとして受け取るプロパティ ハンドラーへの関数ポインターが含まれています。ポートドライバーは 、PCPROPERTY_REQUEST 構造体を割り当て、元のプロパティ要求 ( Irp メンバーが指す) から関連情報を抽出し、ハンドラーを呼び出す前に、この構造体に情報を読み込みます。

WDM オーディオでは、プロパティ要求のターゲットには、フィルターインスタンスまたはピンインスタンスのいずれかを指定できます。ターゲットには、ノード ID を含めることもできます。

クライアントの元のプロパティ要求では、プロパティインスタンスデータは常に KSPROPERTY または KSNODEPROPERTY 構造体で始まりますが、追加情報を含めることができます。ポートドライバーは、この追加情報 (存在する場合) を指すPCPROPERTY_REQUEST構造体の インスタンス メンバーを調整します。詳細については、「オーディオプロパティハンドラー」を参照してください。

MajorTarget メンバーと MinorTarget メンバーは、それぞれ、メインミニポートオブジェクトと関連付けられたストリームオブジェクトへの IUnknown ポインターです。プロパティハンドラーは、これらのオブジェクトのミニポートインターフェイスとストリームインターフェイスに対してクエリを実行できます。プロパティ要求のターゲットがフィルターインスタンスの場合、 MajorTarget はそのフィルターインスタンスのミニポートオブジェクトを指し、 MinorTarget は NULL です。ターゲットがピンインスタンスの場合、 MinorTarget はそのピンのストリームオブジェクトを指し、 MajorTarget はピンがアタッチされているフィルターのミニポートオブジェクトを指します。

たとえば、プロパティ要求のターゲットが WaveCyclic フィルターのピンインスタンスである場合は、次のようになります。

ハンドラーは、MajorTarget オブジェクトの IUnknown インターフェイスで QueryInterface を呼び出して、オブジェクトの IMiniportWaveCyclic インターフェイスへの参照を取得できます。
ハンドラーは、MinorTarget オブジェクトの IUnknown インターフェイスで QueryInterface を呼び出して、オブジェクトの IMiniportWaveCyclicStream インターフェイスへの参照を取得できます。