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 |
|---|---|
|
A referência de ativação do dispositivo de armazenamento foi incrementada com êxito e o componente está no estado ativo. |
|
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. |
|
O adaptador ou unidade não dá suporte a PoFx. |
|
O IRQL atual > DISPATCH_LEVEL. |
|
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 |