VideoPortCreateEvent 函式 (video.h)

VideoPortCreateEvent 函式會建立事件物件。

語法

VIDEOPORT_API VP_STATUS VideoPortCreateEvent(
  [in]  IN PVOID   HwDeviceExtension,
  [in]  IN ULONG   EventFlag,
  [in]  IN PVOID   Unused,
  [out] OUT PEVENT *ppEvent
);

參數

[in] HwDeviceExtension

迷你埠驅動程式裝置延伸模組的指標。

[in] EventFlag

指定事件類型和初始事件狀態。 這可以是下列旗標的 ORed 組合：

旗標	意義
INITIAL_EVENT_SIGNALED	設定此旗標以指出事件物件的訊號狀態。 否則，事件的初始狀態為非簽署狀態。
NOTIFICATION_EVENT	設定此旗標以建立通知事件。 如果未設定此旗標，則會建立同步處理事件。

[in] Unused

目前由視訊埠驅動程式忽略，而且必須設定為 NULL。

[out] ppEvent

將傳回事件對象指標的記憶體位置指標。

傳回值

如果成功建立事件物件，VideoPortCreateEvent 會傳回NO_ERROR。

備註

當同步處理事件設定為訊號狀態時，會釋放等候訊號狀態的單一線程， (其分派狀態從等候轉換為就緒、待命或執行) ，而且事件會自動重設為非簽署狀態。

當通知事件設定為已發出訊號狀態時，會釋放等候訊號狀態的所有線程，而且事件會維持在訊號狀態，直到明確重設為未簽署狀態為止。

規格需求

需求	值
最低支援的用戶端	可在 Windows XP 和更新版本的 Windows 作業系統中使用。
目標平台	桌面
標頭	video.h (包含 Video.h)
程式庫	Videoprt.lib
Dll	Videoprt.sys
IRQL	PASSIVE_LEVEL

另請參閱

VideoPortDeleteEvent