Função StorPortPoFxSetComponentLatency (storport.h)

  • Artigo

A rotina StorPortPoFxSetComponentLatency especifica a latência máxima que pode ser tolerada na transição da condição ociosa para a condição ativa no componente do dispositivo de armazenamento especificado.

Sintaxe

ULONG StorPortPoFxSetComponentLatency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Latency
);

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host). Essa é a extensão de dispositivo usada para registrar o dispositivo em uma chamada anterior para StorPortInitializePoFxPower.

[in, optional] Address

O endereço de uma unidade de dispositivo de armazenamento. Esse parâmetro é NULL ao definir a latência de um componente do adaptador de armazenamento.

[in] Component

O índice que identifica o componente. Esse parâmetro é um índice na matriz Components na estrutura STOR_POFX_DEVICE que o driver de miniporto registrou para o dispositivo com uma chamada para StorPortInitializePoFxPower. Se a matriz Componentes contiver N elementos, os índices de componentes variam de 0 a N-1.

[in] Latency

O tempo, em unidades de 100 nanossegundos, que o componente do dispositivo de armazenamento pode tolerar para uma transição de um estado ocioso do estado ativo.

Retornar valor

A rotina StorPortPoFxSetComponentLatency retorna um destes códigos status:

Código de retorno Descrição
STOR_STATUS_SUCCESS
 A latência do componente foi definida com êxito.
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension ou Device é NULL.

-ou-

O endereço aponta para uma estrutura de endereço de unidade inválida.

-ou-

O dispositivo de armazenamento especificado por Address não foi encontrado.

-ou-

O índice em Componente especifica um componente maior que a contagem de componentes para o dispositivo.
STOR_STATUS_INVALID_DEVICE_REQUEST
 O dispositivo de armazenamento não está registrado com a PoFx (estrutura de gerenciamento de energia).
STOR_STATUS_INVALID_IRQL
 O IRQL atual > DISPATCH_LEVEL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível em começar com Windows 8.
Plataforma de Destino Universal
Cabeçalho storport.h
IRQL <= DISPATCH_LEVEL

Confira também

PoFxSetComponentLatency