KsGenerateEvent 函式（ks.h）

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

語法

KSDDKAPI NTSTATUS KsGenerateEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

[in] EventEntry

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

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

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