IDeviceTopology::GetConnector-Methode (devicetopology.h)

Die GetConnector-Methode ruft den Connector ab, der durch eine Connectornummer angegeben wird.

Syntax

HRESULT GetConnector(
  [in]  UINT       nIndex,
  [out] IConnector **ppConnector
);

Parameter

[in] nIndex

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

[out] ppConnector

Zeiger auf eine Zeigervariable, in die die Methode die Adresse der IConnector-Schnittstelle des Connectorobjekts 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 GetConnector-Aufruf fehlschlägt, ist *ppConnectorNULL.

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	Zeiger ppConnector ist NULL.

Hinweise

Codebeispiele, die die GetConnector-Methode aufrufen, finden Sie in den Implementierungen der Funktionen GetHardwareDeviceTopology und SelectCaptureDevice in Gerätetopologien.

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

IConnector-Schnittstelle

IDeviceTopology-Schnittstelle

IDeviceTopology::GetConnectorCount