IConnector interface (devicetopology.h)
The IConnector interface represents a point of connection between components. The client obtains a reference to an IConnector interface by calling the IDeviceTopology::GetConnector or IConnector::GetConnectedTo method, or by calling the IPart::QueryInterface method with parameter iid set to REFIID IID_IConnector.
An IConnector interface instance can represent:
- An audio jack on a piece of hardware
- An internal connection to an integrated endpoint device (for example, a built-in microphone in a laptop computer)
- A software connection implemented through DMA transfers
A part in a device topology can be either a connector or a subunit. The IPart interface provides methods that are common to connectors and subunits.
For code examples that use the IConnector interface, see the implementations of the GetHardwareDeviceTopology and SelectCaptureDevice functions in Device Topologies.
Inheritance
The IConnector interface inherits from the IUnknown interface. IConnector also has these types of members:
Methods
The IConnector interface has these methods.
| IConnector::ConnectTo The ConnectTo method connects this connector to a connector in another device-topology object. |
| IConnector::Disconnect The Disconnect method disconnects this connector from another connector. |
| IConnector::GetConnectedTo The GetConnectedTo method gets the connector to which this connector is connected. |
| IConnector::GetConnectorIdConnectedTo The GetConnectorIdConnectedTo method gets the global ID of the connector, if any, that this connector is connected to. |
| IConnector::GetDataFlow The GetDataFlow method gets the direction of data flow through this connector. |
| IConnector::GetDeviceIdConnectedTo The GetDeviceIdConnectedTo method gets the device identifier of the audio device, if any, that this connector is connected to. |
| IConnector::GetType The GetType method gets the type of this connector. |
| IConnector::IsConnected The IsConnected method indicates whether this connector is connected to another connector. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | devicetopology.h |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for