PHW_EVENT_ROUTINE回呼函式 (strmini.h)

類別驅動程式會呼叫串流 minidriver 的 StrMiniEvent 例程，以向迷你驅動程式發出訊號，應該啟用或停用事件。

語法

PHW_EVENT_ROUTINE PhwEventRoutine;

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

參數

[in] EventDescriptor

描述事件，以及它是否應該啟用或停用。

傳回值

針對事件啟用事件， StrMiniEvent 會在事件成功啟用時傳回STATUS_SUCCESS，或在失敗時傳回錯誤碼。 類別驅動程式會忽略停用要求上的傳回值。

備註

類別驅動程式會將它傳入 EventDescriptor-EventEntry>中的KSEVENT_ENTRY結構排入佇列。 一旦 StrMiniEvent 結束，就會解除分配 EventDescriptor 的所有其他成員，因此 Minidriver 必須保留的任何 EventData 成員中包含的事件特定數據都應該由 minidriver 儲存。

為此，minidriver 可以直接在KSEVENT_ENTRY結構之後配置空間，方法是在用來宣告事件的 KSEVENT_ITEM 結構之 ExtraEntryData 成員中提供非零值。

規格需求

需求	值
目標平台	桌面
標頭	strmini.h (包含 Strmini.h)