WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT-Funktion (wdfrequest.h)

[Gilt für KMDF und UMDF]

Die WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT-Funktion legt einen Timeoutwert in der WDF_REQUEST_SEND_OPTIONS-Struktur eines Treibers fest.

Syntax

void WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT(
  [in, out] PWDF_REQUEST_SEND_OPTIONS Options,
  [in]      LONGLONG                  Timeout
);

Parameter

[in, out] Options

Ein Zeiger auf die WDF_REQUEST_SEND_OPTIONS Struktur des Treibers.

[in] Timeout

Ein absoluter oder relativer Timeoutwert. Weitere Informationen finden Sie im Timeoutelement der WDF_REQUEST_SEND_OPTIONS-Struktur .

Rückgabewert

Keine

Bemerkungen

Um einen Timeoutwert festzulegen, muss Ihr Treiber WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT aufrufen, nachdem er WDF_REQUEST_SEND_OPTIONS_INIT aufgerufen hat.

Die WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT-Funktion speichert den angegebenen Timeoutwert im Timeoutmember der angegebenen WDF_REQUEST_SEND_OPTIONS-Struktur. Außerdem wird das WDF_REQUEST_SEND_OPTION_TIMEOUT-Flag im Flags-Element der Struktur festgelegt.

Beispiele

Im folgenden Codebeispiel wird eine WDF_REQUEST_SEND_OPTIONS-Struktur initialisiert und ein Timeoutwert für die Struktur festgelegt. (Im Beispiel wird WDF_REL_TIMEOUT_IN_SEC aufgerufen, um einen relativen Timeoutwert von 10 Sekunden anzugeben.) Im Beispiel wird dann die WDF_REQUEST_SEND_OPTIONS-Struktur als Eingabe für WdfUsbTargetPipeWriteSynchronously verwendet.

WDF_REQUEST_SEND_OPTIONS  syncReqOptions;

WDF_REQUEST_SEND_OPTIONS_INIT(
                              &syncReqOptions,
                              0
                              );
WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT(
                                     &syncReqOptions,
                                     WDF_REL_TIMEOUT_IN_SEC(10)
                                     );
status = WdfUsbTargetPipeWriteSynchronously(
                                            pipeHandle,
                                            NULL,
                                            &syncReqOptions,
                                            &writeBufDesc,
                                            NULL
                                            );

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfrequest.h (einschließen von Wdf.h)

Weitere Informationen

WDF_REQUEST_SEND_OPTIONS

WDF_REQUEST_SEND_OPTIONS_INIT