struktur WDF_REQUEST_SEND_OPTIONS (wdfrequest.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Struktur WDF_REQUEST_SEND_OPTIONS menentukan opsi yang terkait dengan pengiriman permintaan I/O ke target I/O.

Sintaks

typedef struct _WDF_REQUEST_SEND_OPTIONS {
  ULONG    Size;
  ULONG    Flags;
  LONGLONG Timeout;
} WDF_REQUEST_SEND_OPTIONS, *PWDF_REQUEST_SEND_OPTIONS;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

Flags

Bitwise OR dari bendera WDF_REQUEST_SEND_OPTIONS_FLAGS-ketik.

Timeout

Nilai waktu habis, dalam unit waktu sistem (interval 100 nanodetik). Jika driver telah mengatur bendera WDF_REQUEST_SEND_OPTION_TIMEOUT, kerangka kerja membatalkan permintaan I/O terkait jika tidak selesai dalam periode waktu habis yang ditentukan. Nilai waktu habis bisa negatif, positif, atau nol, sebagai berikut:

  • Jika nilainya negatif, waktu kedaluwarsa relatif terhadap waktu sistem saat ini.
  • Jika nilainya positif, waktu kedaluwarsa ditentukan sebagai waktu absolut (yang sebenarnya relatif terhadap 1 Januari 1601).
  • Jika nilainya nol, kerangka kerja tidak kehabisan waktu permintaan.
Waktu kedaluwarsa relatif tidak dipengaruhi oleh perubahan apa pun pada waktu sistem yang mungkin terjadi dalam periode waktu habis yang ditentukan. Waktu kedaluwarsa absolut mencerminkan perubahan waktu sistem.

Kerangka kerja menyediakan fungsi konversi waktu yang mengonversi nilai waktu menjadi unit waktu sistem.

Jika kerangka kerja membatalkan permintaan I/O karena periode waktu habis yang ditentukan telah berlalu, kerangka kerja menyediakan status penyelesaian STATUS_IO_TIMEOUT untuk permintaan I/O. Namun, setelah periode waktu habis berlalu, target I/O mungkin menyelesaikan permintaan I/O sebelum kerangka kerja dapat membatalkannya. Dalam hal ini, status penyelesaian permintaan I/O tidak akan STATUS_IO_TIMEOUT.

Keterangan

Struktur WDF_REQUEST_SEND_OPTIONS diteruskan ke metode objek yang mengirim permintaan I/O ke target I/O, seperti metode WdfRequestSend . Struktur harus diinisialisasi dengan memanggil fungsi WDF_REQUEST_SEND_OPTIONS_INIT dan WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT .

Jika driver mengirim permintaan secara sinkron, sebaiknya driver menetapkan nilai waktu habis dan bendera batas waktu di anggota Bendera struktur ini.

Persyaratan

Persyaratan Nilai
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfrequest.h (termasuk Wdf.h)

Lihat juga

WDF_REQUEST_SEND_OPTIONS_FLAGS

WDF_REQUEST_SEND_OPTIONS_INIT

WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT

WdfRequestSend