Função StorPortPoFxSetComponentLatency (storport.h)

Artigo
02/07/2025

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 do 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 componentes 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.

Valor de retorno

A rotina StorPortPoFxSetComponentLatency retorna um destes códigos de status:

Código de retorno	Descrição
STOR_STATUS_SUCCESS	A latência do componente definida com êxito.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension ou Device é NULL. -ou- address aponta para uma estrutura de endereço de unidade inválida. -ou- O dispositivo de armazenamento especificado pelo Address não foi encontrado. -ou- O índice em Component 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 > DISPATCH_LEVEL IRQL atual.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível para começar com o Windows 8.
da Plataforma de Destino	Universal
cabeçalho	storport.h
IRQL	<= DISPATCH_LEVEL

Consulte também

PoFxSetComponentLatency

Compartilhar via