StorPortGetDeviceObjects-Funktion (storport.h)

Artikel
02/29/2024

Die StorPortGetDeviceObjects-Routine gibt die Geräteobjekte zurück, die dem Adaptergerätestapel zugeordnet sind. Die zurückgegebenen Geräteobjekte sind die funktionalen und physischen Geräteobjekte des Adapters und das Geräteobjekt, an das das funktionale Geräteobjekt angefügt ist.

Syntax

ULONG StorPortGetDeviceObjects(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *AdapterDeviceObject,
  [out] PVOID *PhysicalDeviceObject,
  [out] PVOID *LowerDeviceObject
);

Parameter

[in] HwDeviceExtension

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

[out] AdapterDeviceObject

Ein Zeiger zum Empfangen des funktionalen Geräteobjekts (Functional Device Object, FDO) des Adapters.

[out] PhysicalDeviceObject

Ein Zeiger zum Empfangen des physischen Geräteobjekts (PDO).

[out] LowerDeviceObject

Ein Zeiger zum Empfangen des Geräteobjekts des unteren Geräts, an das die FDO angefügt ist.

Rückgabewert

StorPortGetDeviceObjects gibt einen der folgenden status Codes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_NOT_IMPLEMENTED	Diese Funktion ist auf dem aktiven Betriebssystem nicht implementiert.
STOR_STATUS_SUCCESS	Gibt an, dass die Geräteobjekte erfolgreich abgerufen wurden.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension war NULL.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	storport.h (Storport.h einschließen)

Freigeben über