共用方式為

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 結構 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