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 |