Función StorPortPoFxSetIdleTimeout (storport.h)

Un minipuerto puede llamar a storPortPoFxSetIdleTimeout para establecer el valor de tiempo de espera de inactividad de un adaptador, que es la cantidad de tiempo que un adaptador puede estar inactivo antes de obtener la notificación Device Power Not Required.

Sintaxis

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

Parámetros

HwDeviceExtension

[in] Puntero a la extensión del dispositivo del miniporte.

Address

[in] Debe establecerse en NULL porque esta función solo se admite para adaptadores. No pase la dirección de una unidad.

IdleTimeoutInMS

Intervalo de tiempo de espera de inactividad que se va a usar, en milisegundos.

Valor devuelto

storPortPoFxSetIdleTimeout devuelve STOR_STATUS_SUCCESS si la energía en tiempo de ejecución se ha deshabilitado o si el valor de tiempo de espera de inactividad se estableció correctamente. De lo contrario, devuelve un código de error como uno de los siguientes.

Código de error Significado
STOR_STATUS_INVALID_PARAMETER Se pasó una dirección de unidad.
STOR_STATUS_UNSUCCESSFUL La función StorPortInitializePoFxPower no se llamó previamente para el adaptador o no se estableció un valor de tiempo de espera de inactividad.

Observaciones

Si se especificó la marca STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT y el AdapterIdleTimeoutInMS establecido cuando el adaptador se registró para la administración de energía en tiempo de ejecución, ese valor se invalidará IdleTimeoutInMS valor pasado a esta función. Consulte STOR_POFX_DEVICE_V3 para obtener información sobre cómo registrarse para la administración de energía en tiempo de ejecución.

Un miniport solo puede llamar a esta función si anteriormente se llamaba StorPortInitializePoFxPower para el adaptador.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 8
encabezado de storport.h

Consulte también

STOR_POFX_DEVICE_V3

StorPortInitializePoFxPower