функция 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

Абсолютное или относительное значение времени ожидания. Дополнительные сведения см. в разделе Элемент Timeout структуры WDF_REQUEST_SEND_OPTIONS .

Возвращаемое значение

None

Remarks

Чтобы задать значение времени ожидания, драйвер должен вызвать WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT после вызова WDF_REQUEST_SEND_OPTIONS_INIT.

Функция WDF_REQUEST_SEND_OPTIONS_SET_TIMEOUT сохраняет указанное значение времени ожидания в элементе Timeout указанной структуры WDF_REQUEST_SEND_OPTIONS. Он также задает флаг WDF_REQUEST_SEND_OPTION_TIMEOUT в элементе Flags структуры.

Примеры

В следующем примере кода инициализируется структура 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