fonction WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT (wdfrequest.h)

  • Article

[S’applique à KMDF et UMDF]

La fonction WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT définit une valeur de délai d’attente dans la structure de WDF_REQUEST_SEND_OPTIONS d’un pilote.

Syntaxe

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

Paramètres

[in, out] Options

Pointeur vers la structure WDF_REQUEST_SEND_OPTIONS du pilote.

[in] Timeout

Valeur de délai d’attente absolu ou relatif. Pour plus d’informations, consultez le membre Timeout de la structure WDF_REQUEST_SEND_OPTIONS .

Valeur de retour

None

Remarques

Pour définir une valeur de délai d’attente, votre pilote doit appeler WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT après avoir appelé WDF_REQUEST_SEND_OPTIONS_INIT.

La fonction WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT stocke la valeur de délai d’expiration spécifiée dans le membre Timeout de la structure de WDF_REQUEST_SEND_OPTIONS spécifié. Il définit également l’indicateur WDF_REQUEST_SEND_OPTION_TIMEOUT dans le membre Flags de la structure.

Exemples

L’exemple de code suivant initialise une structure WDF_REQUEST_SEND_OPTIONS et définit une valeur de délai d’attente pour la structure. (L’exemple appelle WDF_REL_TIMEOUT_IN_SEC pour spécifier une valeur de délai d’attente relative de 10 secondes.) L’exemple utilise ensuite la structure WDF_REQUEST_SEND_OPTIONS comme entrée dans WdfUsbTargetPipeWriteSynchronously.

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
                                            );

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
Version UMDF minimale 2.0
En-tête wdfrequest.h (include Wdf.h)

Voir aussi

WDF_REQUEST_SEND_OPTIONS

WDF_REQUEST_SEND_OPTIONS_INIT