IKsControl：：KsEvent 方法 (ksproxy.h)

發行項
02/29/2024

KsEvent 方法會啟用或停用事件，以及事件集上可用的任何其他已定義支援作業。

語法

HRESULT KsEvent(
  [in, optional] PKSEVENT Event,
  [in]           ULONG    EventLength,
  [in, out]      LPVOID   EventData,
  [in]           ULONG    DataLength,
  [in, out]      ULONG    *BytesReturned
);

參數

[in, optional] Event

KSEVENT 結構的指標，描述要啟用事件的事件，以及停用事件的 NULL。

[in] EventLength

啟用事件時， 緩衝區 的大小，以位元組為單位，當事件停用時則為零。

[in, out] EventData

KSEVENTDATA 結構的指標，其中包含事件的數據，以及接收事件數據的緩衝區空間。

[in] DataLength

EventData 緩衝區的大小，以位元組為單位。

[in, out] BytesReturned

接收 KsEvent 儲存在 EventData 緩衝區中之數據大小位元組的變數指標。

傳回值

如果成功，則傳回 NOERROR;否則，會傳回錯誤碼。如果呼叫成功，事件會位於驅動程式的事件清單中。

備註

若要停用事件，請將 Event 設定為 NULL、 EventLength 設定為零，並將 EventData 設定為先前用來啟用事件的 KSEVENTDATA 結構的指標。

IKsControl：：KsEvent 的 EventData 參數包含 EventHandle.Event 中的句柄。當迷你驅動程式呼叫 KsXxxGenerateEvents 或 StreamClassStreamNotification 時，您可以等候句柄變成可用並取得通知。