VideoPortWaitForSingleObject 函式 (video.h)

VideoPortWaitForSingleObject 函式會將目前的線程放入等候狀態，直到指定的分派物件設定為訊號狀態，或 (選擇性地) 直到等候逾時為止。

語法

VIDEOPORT_API VP_STATUS VideoPortWaitForSingleObject(
  [in] IN PVOID          HwDeviceExtension,
  [in] IN PVOID          Object,
  [in] IN PLARGE_INTEGER Timeout
);

參數

[in] HwDeviceExtension

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

[in] Object

事件物件的指標。

[in] Timeout

(選擇性) 逾時值的指標，指定等候完成的絕對或相對時間。 負值會指定相對於目前時間的等候間隔。 此值應該以 100 奈秒為單位來表示。 絕對到期時間會追蹤系統時間中的任何變更;相對到期時間不會受到系統時間變更的影響。

傳回值

VideoPortWaitForSingleObject 會傳回下列其中一個值：

傳回碼	Description
ERROR_INVALID_PARAMETER	其中一個參數無效，或呼叫嘗試等候對應的使用者事件。
NO_ERROR	pObject 參數中指定的事件物件符合等候。
WAIT_TIMEOUT	事件物件設定為訊號狀態之前發生逾時。 當無法立即符合指定的等候條件集且 Timeout 設定為零時，可以傳回此值。

備註

迷你埠驅動程序不應該嘗試等候對應的使用者事件。

VideoPortWaitForSingleObject 的呼叫端必須在 IRQL <= DISPATCH_LEVEL執行。 呼叫端通常會在 IRQL = PASSIVE_LEVEL和非bitrary 線程內容中執行。 在 IRQL = DISPATCH_LEVEL 執行時，對這個函式的呼叫只有在呼叫端指定零的 Timeout 值時才有效。 也就是說，迷你埠驅動程式不得在 IRQL = DISPATCH_LEVEL等候非零間隔。

規格需求

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