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 结构的 Timeout 成员。

返回值

无

备注

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

WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT函数将指定的超时值存储在指定的WDF_REQUEST_SEND_OPTIONS结构的 Timeout 成员中。 它还在结构的 Flags 成员中设置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