ksGenerateEvent 函式 (ks.h)

KsGenerateEvent 函式會根據事件專案結構產生標準事件通知。

語法

KSDDKAPI NTSTATUS KsGenerateEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

[in] EventEntry

指定參考事件數據的事件項目結構。此資訊可用來判斷要執行的通知類型。如果通知類型不是其中一個預先定義的標準，則會傳回錯誤。如果是單一非遞迴事件，則從函式傳回時，此專案將會無效。因此，列舉事件清單的任何程式代碼都必須預先遞增，才能取得清單中的下一個事件，再將此事件傳遞至函式。

如果成功， KsGenerateEvent 函式會傳回STATUS_SUCCESS，如果失敗，則會傳回例外狀況或記憶體錯誤。

裝置會決定何時使用 KSEVENT_ENTRY 結構產生事件通知，然後使用此函式來執行實際的通知。 KsGenerateEvent 可以在任何 IRQL 呼叫。如果呼叫上述DISPATCH_LEVEL，則會在 DPC 中以異步方式執行事件的訊號。