Função StorPortPoFxIdleComponent (storport.h)

Artigo
02/29/2024

A rotina StorPortPoFxIdleComponent diminui a contagem de referência de ativação de um componente especificado de um dispositivo de armazenamento.

Sintaxe

ULONG StorPortPoFxIdleComponent(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS       Address,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           ULONG               Component,
  [in]           ULONG               Flags
);

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).

[in, optional] Address

O endereço de uma unidade de dispositivo de armazenamento. Esse parâmetro é NULL ao idling de um componente de adaptador de armazenamento.

[in, optional] Srb

O SRB que dispara a desativação do componente. Esse parâmetro será NULL se o miniporto estiver idling de um componente do dispositivo internamente.

[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 Components contiver N elementos, os índices de componentes variam de 0 a N–1.

[in] Flags

Não usado. Defina como 0.

Retornar valor

A rotina StorPortPoFxIdleComponent retorna um destes códigos status:

Código de retorno	Descrição
STOR_STATUS_SUCCESS	A referência de ativação do dispositivo de armazenamento foi decrementada com êxito e o componente está ocioso.
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 dispositivo de armazenamento não está registrado na PoFx (estrutura de gerenciamento de energia). -ou- O SRB apontado por Srb não é enviado do Storport. -ou- O parâmetro Flags é diferente de zero.
STOR_STATUS_INVALID_DEVICE_REQUEST	O adaptador ou unidade não dá suporte a PoFx. -ou- StorPortPoFxIdleComponent foi chamado com um componente inativo e um Srb para o qual uma chamada anterior para StorPortPoFxActivateComponent não foi executada.
STOR_STATUS_INVALID_IRQL	O > DISPATCH_LEVEL IRQL atual.
STOR_STATUS_BUSY	A referência ativa para o componente do dispositivo foi decrementada, mas o componente ainda está ativo.

Comentários

Atualmente, os dispositivos de adaptador e os dispositivos de unidade têm a contagem máxima de componentes de 1. O índice em Component sempre deve ser definido como 0.

Cada chamada para StorPortPoFxIdleComponent deve corresponder a uma chamada anterior para StorPortPoFxActivateComponent.