Fungsi VideoPortWaitForSingleObject (video.h)

Artikel
02/29/2024

Fungsi VideoPortWaitForSingleObject menempatkan utas saat ini ke dalam status tunggu hingga objek pengiriman yang diberikan diatur ke status yang disinyalkan, atau (opsional) hingga waktu tunggu habis.

Sintaks

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

Parameter

[in] HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

[in] Object

Penunjuk ke objek peristiwa.

[in] Timeout

(Opsional) Penunjuk ke nilai waktu habis yang menentukan waktu absolut atau relatif di mana penantian akan selesai. Nilai negatif menentukan interval tunggu relatif terhadap waktu saat ini. Nilai harus dinyatakan dalam satuan 100 nanodetik. Waktu kedaluwarsa absolut melacak perubahan apa pun dalam waktu sistem; waktu kedaluwarsa relatif tidak terpengaruh oleh perubahan waktu sistem.

Nilai kembali

VideoPortWaitForSingleObject mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Salah satu parameter tidak valid atau panggilan mencoba menunggu peristiwa pengguna yang dipetakan.
NO_ERROR	Objek peristiwa yang ditentukan dalam parameter pObject memenuhi penantian.
WAIT_TIMEOUT	Waktu habis terjadi sebelum objek peristiwa diatur ke status sinyal. Nilai ini dapat dikembalikan ketika kumpulan kondisi tunggu yang ditentukan tidak dapat segera terpenuhi dan Batas waktu diatur ke nol.

Keterangan

Driver miniport tidak boleh mencoba menunggu peristiwa pengguna yang dipetakan.

Pemanggil VideoPortWaitForSingleObject harus berjalan di IRQL <= DISPATCH_LEVEL. Biasanya, pemanggil akan berjalan di IRQL = PASSIVE_LEVEL dan dalam konteks utas nonarbitrer. Panggilan ke fungsi ini saat berjalan di IRQL = DISPATCH_LEVEL valid jika dan hanya jika pemanggil menentukan nilai Batas Waktu nol. Artinya, driver miniport tidak boleh menunggu interval bukan nol di IRQL = DISPATCH_LEVEL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows XP dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	video.h (sertakan Video.h)
Pustaka	Videoprt.lib
DLL	Videoprt.sys
IRQL	<= DISPATCH_LEVEL (lihat bagian Keterangan)

Bagikan melalui