Função StorPortPoFxSetComponentResidency (storport.h)

Artigo
02/26/2024

A rotina StorPortPoFxSetComponentResidency define o tempo estimado para quanto tempo um componente de dispositivo de armazenamento provavelmente permanecerá ocioso depois que o componente entrar na condição ociosa.

Sintaxe

ULONG StorPortPoFxSetComponentResidency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Residency
);

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 residê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] Residency

O tempo estimado de residência, em unidades de 100 nanossegundos. Esse parâmetro é uma dica para a PoFx (estrutura de gerenciamento de energia) sobre quanto tempo o componente provavelmente permanecerá ocioso após uma transição da condição ativa para a condição ociosa.

Retornar valor

A rotina StorPortPoFxSetComponentResidency retorna um destes códigos status:

Código de retorno	Descrição
STOR_STATUS_SUCCESS	A residência do componente é 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 o PoFx.
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
Biblioteca	Storport.lib
IRQL	<= DISPATCH_LEVEL

Confira também

PoFxSetComponentResidency

Partilhar via