IDeviceTopology::GetSignalPath method (devicetopology.h)
The GetSignalPath method gets a list of parts in the signal path that links two parts, if the path exists.
Syntax
HRESULT GetSignalPath(
[in] IPart *pIPartFrom,
[in] IPart *pIPartTo,
[in] BOOL bRejectMixedPaths,
[out] IPartsList **ppParts
);
Parameters
[in] pIPartFrom
Pointer to the "from" part. This parameter is a pointer to the IPart interface of the part at the beginning of the signal path.
[in] pIPartTo
Pointer to the "to" part. This parameter is a pointer to the IPart interface of the part at the end of the signal path.
[in] bRejectMixedPaths
Specifies whether to reject paths that contain mixed data. If bRejectMixedPaths is TRUE (nonzero), the method ignores any data path that contains a mixer (that is, a processing node that sums together two or more input signals). If FALSE, the method will try to find a path that connects the "from" and "to" parts regardless of whether the path contains a mixer.
[out] ppParts
Pointer to a pointer variable into which the method writes the address of an IPartsList interface instance. This interface encapsulates the list of parts in the signal path that connects the "from" part to the "to" part. 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 GetSignalPath call fails, *ppParts 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 |
|---|---|
|
Parameter pIPartFrom, pIPartTo, or ppParts is NULL. |
|
No path linking the two parts was found. |
|
Parameter pIPartFrom or pIPartTo does not point to a valid IPart interface. |
|
Out of memory. |
Remarks
This method creates an IPartsList interface instance that contains a list of the parts that lie along the specified signal path. The parts in the parts list are ordered according to their relative positions in the signal path. The "to" part is the first item in the list and the "from" part is the last item in the list.
If the list contains n parts, the "to" and "from" parts are identified by list indexes 0 and n– 1, respectively. To get the number of parts in a parts list, call the IPartsList::GetCount method. To retrieve a part by its index, call the IPartsList::GetPart method.
The parts in the signal path must all be part of the same device topology. The path cannot span boundaries between device topologies.
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 |