Función StorPortInitializePoFxPower (storport.h)

Un controlador de minipuerto llama a StorPortInitializePoFxPower para registrar un dispositivo de almacenamiento con el marco de administración de energía (PoFx).

Sintaxis

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

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

[in, optional] Address

Dirección de una unidad de dispositivo de almacenamiento. Este parámetro es NULL al registrarse para un adaptador de almacenamiento.

[in] Device

Puntero a una estructura de STOR_POFX_DEVICE_V2 que se convierte en un puntero a STOR_POFX_DEVICE. Esta estructura contiene una lista de componentes con estados F para un dispositivo de almacenamiento.

[in, out] D3ColdEnabled

Puntero a un valor BOOLEAN que el controlador storport establecerá para indicar si el estado D3 frío está habilitado para el dispositivo de almacenamiento.

Valor devuelto

La rutina StorPortInitializePoFxPower devuelve uno de estos códigos de estado:

Código devuelto	Descripción
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension o Device es NULL. O bien La dirección apunta a una estructura de direcciones de unidad no válida. O bien No se encuentra el dispositivo de almacenamiento especificado por Address . O bien La estructura de STOR_POFX_DEVICE a la que apunta device tiene el formato incorrecto o contiene datos no válidos.
STOR_STATUS_SUCCESS	El dispositivo de almacenamiento se registró correctamente con PoFx.
STOR_STATUS_INSUFFICIENT_RESOURCES	Los recursos suficientes no están disponibles para registrar el dispositivo de almacenamiento con PoFx.
STOR_STATUS_UNSUCCESSFUL	El dispositivo de almacenamiento no se registró correctamente con PoFx. O bien El dispositivo de almacenamiento ya está registrado con PoFx.

Comentarios

Los dispositivos adaptadores siempre se registran con un valor NULL para address. Los dispositivos de unidad se registran especificando una dirección de unidad válida para la dirección.

Si la marca de STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD está establecida en el miembro Flags (Marcas ) del dispositivo, Storport intentará habilitar la compatibilidad con D3 Cold para el componente de dispositivo. El estado D3 Cold enabled se devuelve en el valor BOOLEAN al que apunta D3ColdEnabled.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en a partir de Windows 8.
Plataforma de destino	Universal
Encabezado	storport.h

Consulte también

STOR_POFX_DEVICE