KsGenerateDataEvent 函式（ks.h）

當指定事件項目結構和回呼數據時，KsGenerateDataEvent 函式會產生其中一個標準事件通知。這可讓裝置判斷何時應該產生事件通知，但仍使用此協助程式函式來執行實際的通知。

語法

KSDDKAPI NTSTATUS KsGenerateDataEvent(
  [in] PKSEVENT_ENTRY EventEntry,
  [in] ULONG          DataSize,
  [in] PVOID          Data
);

[in] EventEntry

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

[in] DataSize

指定所傳遞資料參數的大小。

[in] Data

指向要傳遞至用戶端回呼的數據。此數據會複製到啟用事件時所設定的其中一個預先配置緩衝區位置。數據的大小必須小於原本配置的任何項目，否則事件將會失敗。

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

假設呼叫此函式之前，已取得事件清單鎖定。此函式可能會導致呼叫事件專案的 RemoveHandler。因此，函式不能呼叫高於鎖定的 IRQ 層級，或 Remove 函式必須能夠處理在這類 IRQ 層級呼叫。

此函式特別適用於透過回呼傳回給用戶端的事件。