Função StorPortInitializePoFxPower (storport.h)

Artigo
02/07/2025

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 de 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 BOOLEAN valor que o driver Storport definirá para indicar se o estado de frio D3 está habilitado para o dispositivo de armazenamento.

Valor de retorno

A rotina StorPortInitializePoFxPower retorna um destes códigos de status:

Código de retorno	Descrição
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- A estrutura de STOR_POFX_DEVICE apontada pelo Device é 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.

Observações

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

Se o sinalizador de STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD estiver definido no Flags membro do Device, o Storport tentará habilitar o suporte a D3 Cold para o componente do dispositivo. O status habilitado para frio D3 é retornado no valor BOOLEAN apontado por D3ColdEnabled.

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

Consulte também

STOR_POFX_DEVICE

Partilhar via