PCPROPERTY_REQUEST構造体 (portcls.h)

[アーティクル]
02/07/2025

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

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

Node

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

PropertyItem

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

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 構造体の Instance メンバーを調整して、この追加情報が存在する場合は参照します。詳細については、「Audio プロパティハンドラーの」を参照してください。

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

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

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

オーディオプロパティの背景情報については、「オーディオエンドポイント、プロパティ、およびイベント」を参照してください。使用可能なオーディオ固有のプロパティの一覧については、「オーディオドライバーのプロパティセットを参照してください。

必要条件

要件	価値
ヘッダー	portcls.h (Portcls.h を含む)

次の方法で共有

PCPROPERTY_REQUEST構造体 (portcls.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース