Função StorPortPoFxSetIdleTimeout (storport.h)

  • Artigo

Um miniporto pode chamar StorPortPoFxSetIdleTimeout para definir o valor de tempo limite ocioso para um adaptador, que é a quantidade de tempo que um adaptador pode ficar ocioso antes de obter a notificação de Energia do Dispositivo Não Necessária.

Sintaxe

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

Parâmetros

HwDeviceExtension

[in] Ponteiro para a extensão de dispositivo do miniporto.

Address

[in] Deve ser definido como NULL porque essa função só tem suporte para adaptadores. Não passe o endereço de uma unidade.

IdleTimeoutInMS

O intervalo de tempo limite ocioso a ser usado, em milissegundos.

Retornar valor

StorPortPoFxSetIdleTimeout retornará STOR_STATUS_SUCCESS se a energia do runtime tiver sido desabilitada ou se o valor de tempo limite ocioso tiver sido definido com êxito. Caso contrário, ele retornará um código de erro como um dos seguintes.

Código do erro Significado
STOR_STATUS_INVALID_PARAMETER Um endereço de unidade foi passado.
STOR_STATUS_UNSUCCESSFUL A função StorPortInitializePoFxPower não foi chamada anteriormente com êxito para o adaptador ou um valor de tempo limite ocioso não foi definido.

Comentários

Se o sinalizador STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT foi especificado e o AdapterIdleTimeoutInMS definido quando o adaptador foi registrado para gerenciamento de energia de runtime, esse valor será substituído pelo valor IdleTimeoutInMS passado para essa função. Consulte STOR_POFX_DEVICE_V3 para obter informações sobre como se registrar no gerenciamento de energia de runtime.

Um miniporto só poderá chamar essa função se ela anteriormente chamasse StorPortInitializePoFxPower para o adaptador.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Cabeçalho storport.h

Confira também

STOR_POFX_DEVICE_V3

StorPortInitializePoFxPower