Função StorPortPoFxSetIdleTimeout (storport.h)
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 receber 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 do 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.
Valor de retorno
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 de 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. |
Observações
Se o sinalizador de 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 por IdleTimeoutInMS valor passado para essa função. Consulte STOR_POFX_DEVICE_V3 para obter informações sobre como se registrar para o gerenciamento de energia de runtime.
Um miniporto só poderá chamar essa função se ela tiver sido chamada anteriormente StorPortInitializePoFxPower para o adaptador.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8 |
| cabeçalho | storport.h |