PHW_EVENT_ROUTINE回呼函式 （strmini.h）

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

語法

PHW_EVENT_ROUTINE PhwEventRoutine;

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

參數

[in] EventDescriptor

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

傳回值

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

言論

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

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

要求

要求	價值
目標平臺	桌面
標頭	strmini.h （包括 Strmini.h）