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 構造体の直後に領域を割り当てることができます。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	strmini.h (Strmini.h を含む)