WDF_REQUEST_SEND_OPTIONS Struktur (wdfrequest.h)
[Gilt für KMDF und UMDF]
Die WDF_REQUEST_SEND_OPTIONS Struktur gibt Optionen an, die dem Senden einer E/A-Anforderung an ein E/A-Ziel zugeordnet sind.
Syntax
typedef struct _WDF_REQUEST_SEND_OPTIONS {
ULONG Size;
ULONG Flags;
LONGLONG Timeout;
} WDF_REQUEST_SEND_OPTIONS, *PWDF_REQUEST_SEND_OPTIONS;
Angehörige
Size
Die Größe dieser Struktur in Byte.
Flags
Ein bitweises ODER von WDF_REQUEST_SEND_OPTIONS_FLAGS-typierten Flags.
Timeout
Ein Timeoutwert in Systemzeiteinheiten (100-Nanosekunden-Intervalle). Wenn der Treiber das WDF_REQUEST_SEND_OPTION_TIMEOUT Flag festgelegt hat, bricht das Framework die zugeordnete E/A-Anforderung ab, wenn sie nicht innerhalb des angegebenen Timeoutzeitraums abgeschlossen ist. Der Timeoutwert kann wie folgt negativ, positiv oder null sein:
- Wenn der Wert negativ ist, ist die Ablaufzeit relativ zur aktuellen Systemzeit.
- Wenn der Wert positiv ist, wird die Ablaufzeit als absolute Zeit angegeben (die tatsächlich relativ zum 1. Januar 1601 ist).
- Wenn der Wert null ist, wird das Framework die Anforderung nicht timeout.
Das Framework bietet Zeitkonvertierungsfunktionen, die Zeitwerte in Systemzeiteinheiten konvertieren.
Wenn das Framework eine E/A-Anforderung abbricht, da der angegebene Timeoutzeitraum abgelaufen ist, stellt das Framework einen Abschlussstatus STATUS_IO_TIMEOUT für die E/A-Anforderung bereit. Nach Ablauf des Timeoutzeitraums kann das E/A-Ziel jedoch die E/A-Anforderung abschließen, bevor das Framework sie abbrechen kann. In diesem Fall wird der Abschlussstatus der E/A-Anforderung nicht STATUS_IO_TIMEOUT.
Bemerkungen
Die WDF_REQUEST_SEND_OPTIONS Struktur wird an Objektmethoden übergeben, die eine E/A-Anforderung an ein E/A-Ziel senden, z. B. die WdfRequestSend--Methode. Die Struktur muss durch Aufrufen der funktionen WDF_REQUEST_SEND_OPTIONS_INIT und WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT initialisiert werden.
Wenn der Treiber die Anforderung synchron sendet, wird empfohlen, dass der Treiber einen Timeoutwert und das Timeout-Flag im Flags Member dieser Struktur festgelegt hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfrequest.h (include Wdf.h) |
Siehe auch
WDF_REQUEST_SEND_OPTIONS_FLAGS