Функция StorPortPoFxSetIdleTimeout (storport.h)

Статья
02/07/2025

Минипорт может вызывать StorPortPoFxSetIdleTimeout, чтобы задать значение времени ожидания простоя для адаптера, что является временем простоя адаптера перед получением уведомления об устройстве Power Not Required.

Синтаксис

ULONG StorPortPoFxSetIdleTimeout(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS Address,
  ULONG         IdleTimeoutInMS
);

Параметры

HwDeviceExtension

[in] Указатель на расширение устройства минипорта.

Address

[in] Необходимо задать значение NULL, так как эта функция поддерживается только для адаптеров. Не передайте адрес единицы.

IdleTimeoutInMS

Интервал времени ожидания простоя, используемый в миллисекундах.

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

StorPortPoFxSetIdleTimeout возвращает STOR_STATUS_SUCCESS, если питание среды выполнения отключено или если значение времени ожидания простоя было установлено успешно. В противном случае возвращается код ошибки, например один из следующих.

Код ошибки	Значение
STOR_STATUS_INVALID_PARAMETER	Передан адрес единицы.
STOR_STATUS_UNSUCCESSFUL	Функция StorPortInitializePoFxPower не была успешно вызвана для адаптера или значение времени ожидания простоя не задано.

Замечания

Если был указан флаг STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT, а AdapterIdleTimeoutInMS задано при регистрации адаптера для управления питанием среды выполнения, это значение будет переопределено IdleTimeoutInMS значение, переданное этой функции. Сведения о регистрации для управления питанием среды выполнения см. в STOR_POFX_DEVICE_V3.

Минипорт может вызывать эту функцию только в том случае, если он ранее вызывался StorPortInitializePoFxPower для адаптера.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
заголовка	storport.h

См. также

STOR_POFX_DEVICE_V3

StorPortInitializePoFxPower

Поделиться через