WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT-Funktion (wdfrequest.h)

Artikel
2025-02-07

[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 Timeout Member der WDF_REQUEST_SEND_OPTIONS-Struktur.

Rückgabewert

Nichts

Bemerkungen

Um einen Timeoutwert festzulegen, muss ihr Treiber WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT aufrufen, nachdem er WDF_REQUEST_SEND_OPTIONS_INITaufgerufen hat.

Die WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT-Funktion speichert den angegebenen Timeoutwert im WDF_REQUEST_SEND_OPTIONSTimeout-Element der angegebenen 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.) Anschließend wird die WDF_REQUEST_SEND_OPTIONS Struktur als Eingabe verwendet, um WdfUsbTargetPipeWriteSynchronously zu.

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-	Universal
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfrequest.h (include Wdf.h)

Siehe auch

WDF_REQUEST_SEND_OPTIONS

WDF_REQUEST_SEND_OPTIONS_INIT

Freigeben über