Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
The GetConnectedTo method gets the connector to which this connector is connected.
Syntax
HRESULT GetConnectedTo(
[out] IConnector **ppConTo
);
Parameters
[out] ppConTo
Pointer to a pointer variable into which the method writes the address of the IConnector interface of the other connector object. Through this method, the caller obtains a counted reference to the interface. The caller is responsible for releasing the interface, when it is no longer needed, by calling the interface's Release method. If the GetConnectedTo call fails, *ppConTo is NULL.
Return value
If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.
| Return code | Description |
|---|---|
|
Pointer ppConTo is NULL. |
|
This connector is not connected, or the other side of the connection is not another device topology (for example, a Software_IO connection). |
|
The device topology on the other side of the connection is not active (that is, the device state is not DEVICE_STATE_ACTIVE). |
Remarks
For code examples that call this method, see the implementations of the GetHardwareDeviceTopology and SelectCaptureDevice functions in Device Topologies.
For information about Software_IO connections, see ConnectorType Enumeration. For information about the HRESULT_FROM_WIN32 macro, see the Windows SDK documentation. For information about the DEVICE_STATE_NOTPRESENT device state, see DEVICE_STATE_XXX Constants.
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 |