StorPortInitializePoFxPower-Funktion (storport.h)

  • Artikel

Ein Miniporttreiber ruft StorPortInitializePoFxPower auf, um ein Speichergerät beim Power Management Framework (PoFx) zu registrieren.

Syntax

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

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Host Bus Adapter (HBA).

[in, optional] Address

Die Adresse einer Speichergeräteeinheit. Dieser Parameter ist NULL bei der Registrierung für einen Speicheradapter.

[in] Device

Ein Zeiger auf eine STOR_POFX_DEVICE_V2 Struktur, die in einen Zeiger auf STOR_POFX_DEVICE umgewandelt wird. Diese Struktur enthält eine Komponentenliste mit F-Zuständen für ein Speichergerät.

[in, out] D3ColdEnabled

Ein Zeiger auf einen BOOLEAN-Wert , den der Storport-Treiber festlegt, um anzugeben, ob der D3 Cold-Zustand für das Speichergerät aktiviert ist.

Rückgabewert

Die StorPortInitializePoFxPower-Routine gibt einen der folgenden status Codes zurück:

Rückgabecode Beschreibung
STOR_STATUS_INVALID_PARAMETER
 Entweder HwDeviceExtension oder Device ist NULL.

Oder

Address verweist auf eine ungültige Einheitenadressstruktur.

Oder

Das durch Adresse angegebene Speichergerät wurde nicht gefunden.

Oder

Die STOR_POFX_DEVICE Struktur, auf die von Device verwiesen wird , ist falsch formatiert oder enthält ungültige Daten.
STOR_STATUS_SUCCESS
 Das Speichergerät wurde erfolgreich bei PoFx registriert.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Es stehen keine ausreichenden Ressourcen für die Registrierung des Speichergeräts bei PoFx zur Verfügung.
STOR_STATUS_UNSUCCESSFUL
 Das Speichergerät wurde nicht erfolgreich bei PoFx registriert.

Oder

Das Speichergerät ist bereits bei PoFx registriert.

Hinweise

Adaptergeräte werden immer mit dem NULL-Wert für die Adresse registriert. Geräte werden registriert, indem eine gültige Einheitsadresse für die Adresse angegeben wird.

Wenn das STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD-Flag im Flags-Element von Device festgelegt ist, versucht Storport, die D3 Cold-Unterstützung für die Gerätekomponente zu aktivieren. Der D3 Cold-aktivierte status wird im BOOLEAN-Wert zurückgegeben, auf den D3ColdEnabled verweist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 8.
Zielplattform Universell
Header storport.h

Weitere Informationen

STOR_POFX_DEVICE