StorPortInitializePoFxPower-Funktion (storport.h)

Artikel
02/07/2025

Ein Miniporttreiber ruft StorPortInitializePoFxPower auf, um ein Speichergerät mit dem 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 Hostbusadapter (HBA).

[in, optional] Address

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

[in] Device

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

[in, out] D3ColdEnabled

Ein Zeiger auf einen VOM TYP BOOLEAN Wert, den der Storport-Treiber festgelegt hat, um anzugeben, ob der D3-Kaltzustand für das Speichergerät aktiviert ist.

Rückgabewert

Die StorPortInitializePoFxPower Routine gibt einen der folgenden Statuscodes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_INVALID_PARAMETER	Entweder HwDeviceExtension oder Device ist NULL. -oder- Address verweist auf eine ungültige Einheitenadressenstruktur. -oder- Das durch Address angegebene Speichergerät wurde nicht gefunden. -oder- Die STOR_POFX_DEVICE Struktur, auf die Device verweist, ist falsch formatiert oder enthält ungültige Daten.
STOR_STATUS_SUCCESS	Das Speichergerät wurde erfolgreich bei PoFx registriert.
STOR_STATUS_INSUFFICIENT_RESOURCES	Ausreichende Ressourcen sind nicht verfügbar, um das Speichergerät bei PoFx zu registrieren.
STOR_STATUS_UNSUCCESSFUL	Das Speichergerät wurde bei PoFx nicht erfolgreich registriert. -oder- Das Speichergerät ist bereits bei PoFx registriert.

Bemerkungen

Adaptergeräte werden immer mit einem NULL- Wert für Adresseregistriert. Einheitengeräte werden registriert, indem eine gültige Einheitenadresse für Adresseangegeben wird.

Wenn das STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD Flag im Flags Mitglied von Devicefestgelegt ist, versucht Storport, die D3 Cold-Unterstützung für die Gerätekomponente zu aktivieren. Der D3 Cold enabled status is returned in the BOOLEAN value point to by D3ColdEnabled.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Ab Windows 8 verfügbar.
Zielplattform-	Universal
Header-	storport.h

Siehe auch

STOR_POFX_DEVICE

Freigeben über