Função StorPortInitializePoFxPower (storport.h)

Um driver de miniporto chama StorPortInitializePoFxPower para registrar um dispositivo de armazenamento com a PoFx (estrutura de gerenciamento de energia).

Sintaxe

ULONG StorPortInitializePoFxPower(
  [in]           PVOID             HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS     Address,
  [in]           PSTOR_POFX_DEVICE Device,
  [in, out]      PBOOLEAN          D3ColdEnabled
);

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 se registrar em um adaptador de armazenamento.

[in] Device

Um ponteiro para uma estrutura STOR_POFX_DEVICE_V2 convertido em um ponteiro para STOR_POFX_DEVICE. Essa estrutura contém uma lista de componentes com estados F para um dispositivo de armazenamento.

[in, out] D3ColdEnabled

Um ponteiro para um valor BOOLEAN que o driver storport definirá para indicar se o estado frio D3 está habilitado para o dispositivo de armazenamento.

Retornar valor

A rotina StorPortInitializePoFxPower retorna um destes códigos status:

Código de retorno	Descrição
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- A estrutura STOR_POFX_DEVICE apontada pelo Dispositivo é formatada incorretamente ou contém dados inválidos.
STOR_STATUS_SUCCESS	O dispositivo de armazenamento foi registrado com êxito com PoFx.
STOR_STATUS_INSUFFICIENT_RESOURCES	Recursos suficientes não estão disponíveis para registrar o dispositivo de armazenamento com PoFx.
STOR_STATUS_UNSUCCESSFUL	O dispositivo de armazenamento não foi registrado com êxito com PoFx. -ou- O dispositivo de armazenamento já está registrado com PoFx.

Comentários

Os dispositivos adaptador são sempre registrados com um valor NULL para endereço. Os dispositivos de unidade são registrados especificando um endereço de unidade válido para o endereço.

Se o sinalizador STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD estiver definido no membro Flags do Dispositivo, o Storport tentará habilitar o suporte A frio D3 para o componente do dispositivo. A status habilitada para Frio D3 é retornada no valor BOOLEAN apontado por D3ColdEnabled.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível em começar com Windows 8.
Plataforma de Destino	Universal
Cabeçalho	storport.h

Confira também

STOR_POFX_DEVICE