struktur WDF_REQUEST_SEND_OPTIONS (wdfrequest.h)
[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.
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