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 |
|---|---|
|
Parameter nIndex liegt außerhalb des Bereichs. |
|
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 |