PCPFNEVENT_HANDLER コールバック関数 (portcls.h)
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 ルーチンは、非ページ メモリ内に存在する必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | portcls.h (Portcls.h を含む) |
関連項目
IPortEvents::AddEventToEventList