PCPFNEVENT_HANDLER コールバック関数 (portcls.h)

[アーティクル]
02/27/2024

ルーチンは EventHandler イベント要求を処理します。

構文

PCPFNEVENT_HANDLER PcpfneventHandler;

NTSTATUS PcpfneventHandler(
  [in] PPCEVENT_REQUEST EventRequest
)
{...}

パラメーター

[in] EventRequest

初期化された PCEVENT_REQUEST 構造体へのポインター

戻り値

イベントハンドラーは、呼び出しが成功した場合にSTATUS_SUCCESSを返します。それ以外の場合は、適切なエラーコードを返します。

注釈

ミニポートドライバーが公開する各イベントは、イベントハンドラーに関連付けられます。イベントハンドラーの目的は、ポートドライバーとそのクライアントからのイベント要求を処理することです。 EventRequest は、イベントに関する次の情報を含むハンドラーへの入力パラメーターです。

イベントセット GUID とイベント ID。
イベントをトリガーする方法。
ターゲットミニポートオブジェクトと (ピンの場合) ストリームオブジェクトへのポインター。

これは、プロパティ要求で提供される情報の種類に似ています。

ミニポートドライバーは、その IMiniport::GetDescription メソッドを介してそのイベントハンドラーを公開します。このメソッドは、ミニポートドライバーとそれに関連付けられているポートドライバーが一緒に実装するフィルターを定義する記述子構造体 ( PCFILTER_DESCRIPTOR参照) を出力します。この構造体には、ミニポートドライバーのオートメーションテーブルへのポインター ( PCAUTOMATION_TABLE参照) が含まれています。このテーブルには、ミニポートドライバーのイベントの配列へのポインターが含まれます。各配列要素は PCEVENT_ITEM 構造体であり、イベントのハンドラーへのPCPFNEVENT_HANDLER関数ポインターが含まれています。

ルーチンは EventHandler 、非ページメモリに存在する必要があります。