通过

WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT函数 （wdfrequest.h）

  • 项目

[适用于 KMDF 和 UMDF]

WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT 函数在驱动程序的 WDF_REQUEST_SEND_OPTIONS 结构中设置超时值。

语法

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

参数

[in, out] Options

指向驱动程序 WDF_REQUEST_SEND_OPTIONS 结构的指针。

[in] Timeout

绝对或相对超时值。 有关详细信息，请参阅 WDF_REQUEST_SEND_OPTIONS 结构的 超时 成员。

返回值

没有

言论

若要设置超时值，驱动程序必须在调用 WDF_REQUEST_SEND_OPTIONS_INIT后调用 WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT。

WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT 函数将指定的超时值存储在指定的 WDF_REQUEST_SEND_OPTIONS 结构的 超时 成员中。 它还在结构的 标志 成员中设置 WDF_REQUEST_SEND_OPTION_TIMEOUT 标志。

例子

下面的代码示例初始化 WDF_REQUEST_SEND_OPTIONS 结构并设置结构的超时值。 （示例调用 WDF_REL_TIMEOUT_IN_SEC 指定相对超时值 10 秒。然后，该示例使用 WDF_REQUEST_SEND_OPTIONS 结构作为输入来 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
                                            );

要求

要求 价值
目标平台 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfrequest.h （包括 Wdf.h）

另请参阅

WDF_REQUEST_SEND_OPTIONS

WDF_REQUEST_SEND_OPTIONS_INIT