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 を含む) |