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

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 wdfrequest.h (包含 Wdf.h)

另請參閱

WDF_REQUEST_SEND_OPTIONS

WDF_REQUEST_SEND_OPTIONS_INIT