Compartir a través de

Función StorPortInitializePoFxPower (storport.h)

  • Artículo

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