IPart::GetLocalId-Methode (devicetopology.h)
Die GetLocalId-Methode ruft die lokale ID dieses Teils ab.
Syntax
HRESULT GetLocalId(
[out] UINT *pnId
);
Parameter
[out] pnId
Zeiger auf eine UINT-Variable , in die die Methode die lokale ID dieses Teils schreibt.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zeiger pnId ist NULL. |
Hinweise
Wenn Sie über einen Zeiger auf ein Teilobjekt verfügen, können Sie diese Methode aufrufen, um die lokale ID des Teils abzurufen. Eine lokale ID ist eine Zahl, die einen Teil unter allen Teilen 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. Die IDeviceTopology::GetPartById-Methode ruft einen Teil ab, der durch seine lokale ID identifiziert wird.
Codebeispiele, die die GetLocalId-Methode verwenden, finden Sie in den folgenden Themen:
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 |
Weitere Informationen
IAudioInputSelector::GetSelection
IAudioInputSelector::SetSelection
IAudioOutputSelector::GetSelection