IDeviceTopology::GetSubunit-Methode (devicetopology.h)

Die GetSubunit-Methode ruft die Untereinheit ab, die durch eine Untereinheitsnummer angegeben wird.

Syntax

HRESULT GetSubunit(
  [in]  UINT     nIndex,
  [out] ISubunit **ppSubunit
);

Parameter

[in] nIndex

Die Untereinheitsnummer. Wenn eine Gerätetopologie n Untereinheiten enthält, werden die Untereinheiten von 0 bis n– 1 nummeriert. Rufen Sie die IDeviceTopology::GetSubunitCount-Methode auf, um die Anzahl der Untereinheiten in der Gerätetopologie abzurufen.

[out] ppSubunit

Zeiger auf eine Zeigervariable, in die die Methode die Adresse der ISubunit-Schnittstelle des Untereinheitsobjekts schreibt. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für die Freigabe der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem er die Release-Methode der Schnittstelle aufruft. Wenn der GetSubunit-Aufruf fehlschlägt, ist *ppSubunitNULL.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_INVALIDARG	Parameter nIndex liegt außerhalb des Bereichs.
E_POINTER	Der Zeiger ppSubunit ist NULL.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	devicetopology.h

Weitere Informationen

IDeviceTopology-Schnittstelle

IDeviceTopology::GetSubunitCount

ISubunit-Schnittstelle