IDeviceTopology::GetPartById-Methode (devicetopology.h)

Artikel
08/23/2023

Die GetPartById-Methode ruft einen Teil ab, der durch seine lokale ID identifiziert wird.

Syntax

HRESULT GetPartById(
  [in]  UINT  nId,
  [out] IPart **ppPart
);

Parameter

[in] nId

Der abzurufende Teil. Dieser Parameter ist die lokale ID des Teils. Weitere Informationen finden Sie in den Hinweisen.

[out] ppPart

Zeiger auf eine Zeigervariable, in die die Methode die Adresse der IPart-Schnittstelle des durch nId identifizierten Part-Objekts 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 GetPartById-Aufruf fehlschlägt, ist *ppPartNULL.

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 nId ist keine gültige lokale ID.
E_POINTER	Zeiger ppPart ist NULL.

Hinweise

Eine lokale ID ist eine Zahl, die einen Teil unter allen Teilen in einer Gerätetopologie eindeutig identifiziert. Die Methoden IAudioInputSelector::GetSelection und IAudioOutputSelector::GetSelection rufen die lokale ID eines verbundenen Teils ab. Die Methoden IAudioInputSelector::SetSelection und IAudioOutputSelector::SetSelection wählen die Eingabe oder Ausgabe aus, die mit einem Teil verbunden ist, das durch seine lokale ID identifiziert wird. Wenn Sie über einen Zeiger auf ein Teilobjekt verfügen, können Sie die IPart::GetLocalId-Methode aufrufen, um die lokale ID des Teils abzurufen.

Anforderungen

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