Função StorPortPoFxActivateComponent (storport.h)

A rotina StorPortPoFxActivateComponent incrementa a contagem de referência de ativação no componente especificado de um dispositivo de armazenamento.

Sintaxe

ULONG StorPortPoFxActivateComponent(
  [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 ativar um componente do adaptador de armazenamento.

[in, optional] Srb

O SRB que dispara a ativação do componente. Esse parâmetro será NULL se o miniporto estiver ativando um componente de dispositivo para uma solicitação não enviada por meio do Storport.

[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] Flags

Não usado. Defina como 0.

Retornar valor

A rotina StorPortPoFxActivateComponent 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 incrementada com êxito e o componente está no estado ativo.
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 com a PoFx (estrutura de gerenciamento de energia). -ou- O SRB apontado por Srb não é enviado do Storport. -ou- O parâmetro Flags não é zero.
STOR_STATUS_INVALID_DEVICE_REQUEST	O adaptador ou unidade não dá suporte a PoFx.
STOR_STATUS_INVALID_IRQL	O IRQL atual > DISPATCH_LEVEL.
STOR_STATUS_BUSY	A referência de ativação do dispositivo de armazenamento foi incrementada com êxito, mas o componente ainda está no estado ocioso

Comentários

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

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

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	IRQL <= DISPATCH_LEVEL

Confira também

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent