Fungsi StorPortWaitForSingleObject (storport.h)

  • Artikel

Miniport dapat memanggil fungsi StorPortWaitForSingleObject untuk menempatkan utas saat ini ke dalam status tunggu hingga objek dispatcher yang diberikan diatur ke status bersinyaliat atau waktu habis opsional.

Sintaks

ULONG StorPortWaitForSingleObject(
  PVOID          HwDeviceExtension,
  PVOID          Object,
  BOOLEAN        Alertable,
  PLARGE_INTEGER Timeout
);

Parameter

HwDeviceExtension

Arahkan ke ekstensi perangkat miniport penyimpanan.

Object

Penunjuk ke objek dispatcher yang diinisialisasi (peristiwa, mutex, semaphore, thread, atau timer).

Alertable

Nilai Boolean diatur TRUE jika penantian dapat diperingatkan dan FALSE sebaliknya.

Timeout

Arahkan ke nilai batas waktu yang menentukan waktu absolut atau relatif, dalam unit 100-nanodetik, di mana penantian akan selesai.

Nilai positif menentukan waktu absolut, relatif terhadap 1 Januari 1601. Nilai negatif menentukan interval relatif terhadap waktu saat ini. Waktu kedaluwarsa absolut melacak perubahan apa pun dalam waktu sistem; waktu kedaluwarsa relatif tidak terpengaruh oleh perubahan waktu sistem.

Jika Waktu Habis = 0, rutinitas akan kembali tanpa menunggu. Jika miniport memasok pointer NULL, rutinitas menunggu tanpa batas waktu sampai objek dispatcher diatur ke status bersinyali. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Nilai kembali

StorPortSetEvent mengembalikan kode status seperti salah satu hal berikut:

Menampilkan kode Deskripsi
STOR_STATUS_INVALID_PARAMETER Satu atau beberapa parameter tidak valid.
STOR_STATUS_SUCCESS Peristiwa ETW berhasil dicatat.
STOR_STATUS_UNSUCCESSFUL Operasi gagal.

Keterangan

Lihat KeWaitForSingleObject untuk detail selengkapnya.

Penelepon StorportWaitForSingleObject harus berjalan di IRQL <= DISPATCH_LEVEL. Namun, jika Waktu Habis = NULL atau Waktu Habis != 0, pemanggil harus berjalan di IRQL <= APC_LEVEL dan dalam konteks utas non-acak. (Jika Waktu Habis != NULL dan Waktu Habis = 0, pemanggil harus berjalan di IRQL <= DISPATCH_LEVEL.)

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, version 2004
Header storport.h

Lihat juga

KeWaitForsingleObject

StorportInitializeEvent

StorportSetEvent