PCEVENT_REQUEST 構造体 (portcls.h)

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

PCEVENT_REQUEST構造体は、イベント要求を指定します。

構文

typedef struct _PCEVENT_REQUEST {
  PUNKNOWN           MajorTarget;
  PUNKNOWN           MinorTarget;
  ULONG              Node;
  const PCEVENT_ITEM *EventItem;
  PKSEVENT_ENTRY     EventEntry;
  ULONG              Verb;
  PIRP               Irp;
} PCEVENT_REQUEST, *PPCEVENT_REQUEST;

メンバー

MajorTarget

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

MinorTarget

MajorTarget ミニポートオブジェクトに関連付けられているストリームオブジェクトへの IUnknown ポインター。このメンバーには、ポートドライバーが以前に IMiniportXxx::NewStream メソッド (たとえば、IMiniportWaveCyclic::NewStream メソッドの Stream パラメーター) から取得したストリームオブジェクトポインターが含まれています。

Node

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

EventItem

この要求の PCEVENT_ITEM 構造体へのポインター

EventEntry

この要求の KSEVENT_ENTRY 構造体へのポインター

Verb

イベント要求の種類を指定します。このメンバーは、次の表のいずれかの値に設定する必要があります。

値	意味
PCEVENT_VERB_ADD	クライアントが指定したイベントを有効にすることを示します。イベントとターゲットの情報を検証した後、 EventHandler ルーチンは IPortEvents::AddEventToEventList メソッドを呼び出してイベントを追加します。
PCEVENT_VERB_REMOVE	イベントが無効になっており、リストから削除されていることを EventHandler に通知します。
PCEVENT_VERB_SUPPORT	この要求は、サポートのためのクエリです。ミニポートドライバーは、要求で識別されたターゲットのイベントをサポートする場合は、このクエリに成功する必要があります。それ以外の場合は、クエリが失敗します。
PCEVENT_VERB_NONE	対処は必要ありません。

Irp

イベント要求を含む IRP へのポインター

注釈

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

WDM オーディオでは、イベント要求のターゲットをピンインスタンスにすることはできますが、フィルターインスタンスにすることはできません。ターゲットには、ノード ID を含めることもできます。

MajorTarget メンバーと MinorTarget メンバーは、それぞれ、メインミニポートオブジェクトと関連付けられたストリームオブジェクトへの IUnknown ポインターです。イベントハンドラーは、これらのオブジェクトのミニポートインターフェイスとストリームインターフェイスに対してクエリを実行できます。

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

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