Função StorPortPoFxIdleComponent (storport.h)

Artigo
02/07/2025

O StorPortPoFxIdleComponent decrementa 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 do 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 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] Flags

Não usado. Definido como 0.

Valor de retorno

A rotina StorPortPoFxIdleComponent retorna um destes códigos de 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- 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 dispositivo de armazenamento não está registrado com a PoFx (estrutura de gerenciamento de energia). -ou- O SRB apontado por Srb não é enviado de Storport. -ou- O parâmetro sinalizadores de não é 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 decremente, mas o componente ainda está ativo.

Observações

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

Cada chamada para StorPortPoFxIdleComponent deve ser correspondida com uma chamada anterior para StorPortPoFxActivateComponent.

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	Qualquer

Consulte também

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxActivateComponent

Partilhar via