次の方法で共有

PHW_EVENT_ROUTINE コールバック関数 (strmini.h)

  • [アーティクル]

クラス ドライバーは、ストリーム ミニドライバーの StrMiniEvent ルーチンを呼び出して、イベントを有効または無効にする必要があることをミニドライバーに通知します。

構文

PHW_EVENT_ROUTINE PhwEventRoutine;

NTSTATUS PhwEventRoutine(
  [in] IN PHW_EVENT_DESCRIPTOR EventDescriptor
)
{...}

パラメーター

[in] EventDescriptor

イベントと、イベントを有効にするか無効にするかを説明します。

戻り値

イベント有効化イベントの場合、StrMiniEvent は、イベントが正常に有効になっている場合、またはエラー発生時にエラー コードがSTATUS_SUCCESSを返します。 クラス ドライバーは、無効な要求の戻り値を無視します。

備考

クラス ドライバーは、EventDescriptor ->EventEntry渡す KSEVENT_ENTRY 構造体をキューに入れます。 EventDescriptor の他のすべてのメンバーは、StrMiniEvent が終了 一度割り当てが解除されるため、ミニドライバーが保持する必要がある EventDescriptor の EventData メンバーに含まれるイベント固有のデータは、ミニドライバーによって格納される必要があります。

そのため、ミニドライバーは、イベントの宣言に使用する KSEVENT_ITEM 構造体の ExtraEntryData メンバーに 0 以外の値を指定することで、KSEVENT_ENTRY構造体の直後に領域を割り当てることができます。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー strmini.h (Strmini.h を含む)