IDeviceTopology::GetSignalPath 메서드(devicetopology.h)
GetSignalPath 메서드는 경로가 있는 경우 두 부분을 연결하는 신호 경로의 파트 목록을 가져옵니다.
구문
HRESULT GetSignalPath(
[in] IPart *pIPartFrom,
[in] IPart *pIPartTo,
[in] BOOL bRejectMixedPaths,
[out] IPartsList **ppParts
);
매개 변수
[in] pIPartFrom
"from" 부분에 대한 포인터입니다. 이 매개 변수는 신호 경로의 시작 부분에 있는 파트의 IPart 인터페이스에 대한 포인터입니다.
[in] pIPartTo
"to" 부분에 대한 포인터입니다. 이 매개 변수는 신호 경로 끝에 있는 파트의 IPart 인터페이스에 대한 포인터입니다.
[in] bRejectMixedPaths
혼합 데이터가 포함된 경로를 거부할지 여부를 지정합니다. bRejectMixedPaths가 TRUE(0이 아닌 경우) 메서드는 믹서가 포함된 데이터 경로(즉, 둘 이상의 입력 신호를 합산하는 처리 노드)를 무시합니다. FALSE이면 메서드는 경로에 믹서가 포함되어 있는지 여부에 관계없이 "from" 및 "to" 부분을 연결하는 경로를 찾으려고 합니다.
[out] ppParts
메서드가 instance IPartsList 인터페이스의 주소를 쓰는 포인터 변수에 대한 포인터입니다. 이 인터페이스는 "from" 부분을 "to" 파트에 연결하는 신호 경로의 파트 목록을 캡슐화합니다. 이 메서드를 통해 호출자는 인터페이스에 대한 계산된 참조를 가져옵니다. 호출자는 인터페이스의 Release 메서드를 호출하여 더 이상 필요하지 않은 경우 인터페이스를 해제 할 책임이 있습니다. GetSignalPath 호출이 실패하면 *ppParts는 NULL입니다.
반환 값
메서드가 성공하면 S_OK가 반환되고, 실패할 경우 가능한 반환 코드는 다음 표에 표시된 값을 포함하지만 이에 국한되지 않습니다.
| 반환 코드 | 설명 |
|---|---|
|
pIPartFrom, pIPartTo 또는 ppParts 매개 변수는 NULL입니다. |
|
두 부분을 연결하는 경로를 찾을 수 없습니다. |
|
매개 변수 pIPartFrom 또는 pIPartTo 는 유효한 IPart 인터페이스를 가리키지 않습니다. |
|
메모리가 부족합니다. |
설명
이 메서드는 지정된 신호 경로를 따라 있는 부분 목록을 포함하는 IPartsList 인터페이스 instance 만듭니다. 부품 목록의 파트는 신호 경로의 상대 위치에 따라 정렬됩니다. "to" 부분은 목록의 첫 번째 항목이고 "from" 부분은 목록의 마지막 항목입니다.
목록에 n 개의 파트가 포함된 경우 "to" 및 "from" 파트는 각각 목록 인덱스 0 및 n– 1로 식별됩니다. 파트 목록의 파트 수를 얻으려면 IPartsList::GetCount 메서드를 호출합니다. 인덱스로 파트를 검색하려면 IPartsList::GetPart 메서드를 호출합니다.
신호 경로의 파트는 모두 동일한 디바이스 토폴로지의 일부여야 합니다. 경로는 디바이스 토폴로지 간의 경계를 넘을 수 없습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | devicetopology.h |