KsGenerateDataEvent 函式 (ks.h)

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

語法

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

[in] EventEntry

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

[in] DataSize

指定傳遞 之 Data 參數的位元元元大小。

[in] Data

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

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

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

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