Partilhar via


função WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT (wdfrequest.h)

[Aplica-se a KMDF e UMDF]

A função WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT define um valor de tempo limite na estrutura de WDF_REQUEST_SEND_OPTIONS de um driver.

Sintaxe

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

Parâmetros

[in, out] Options

Um ponteiro para a estrutura de WDF_REQUEST_SEND_OPTIONS do driver.

[in] Timeout

Um valor de tempo limite absoluto ou relativo. Para obter mais informações, consulte o membro Timeout da estrutura WDF_REQUEST_SEND_OPTIONS .

Retornar valor

Nenhum

Comentários

Para definir um valor de tempo limite, o driver deve chamar WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT depois de chamar WDF_REQUEST_SEND_OPTIONS_INIT.

A função WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT armazena o valor de tempo limite especificado no membro Timeout da estrutura WDF_REQUEST_SEND_OPTIONS especificado. Ele também define o sinalizador WDF_REQUEST_SEND_OPTION_TIMEOUT no membro Flags da estrutura.

Exemplos

O exemplo de código a seguir inicializa uma estrutura WDF_REQUEST_SEND_OPTIONS e define um valor de tempo limite para a estrutura . (O exemplo chama WDF_REL_TIMEOUT_IN_SEC para especificar um valor de tempo limite relativo de 10 segundos.) Em seguida, o exemplo usa a estrutura WDF_REQUEST_SEND_OPTIONS como entrada para 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
                                            );

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfrequest.h (inclua Wdf.h)

Confira também

WDF_REQUEST_SEND_OPTIONS

WDF_REQUEST_SEND_OPTIONS_INIT