PcRegisterPhysicalConnection 함수(portcls.h)
PcRegisterPhysicalConnection 함수는 동일한 어댑터 드라이버에 의해 인스턴스화된 두 오디오 어댑터 필터 간의 물리적 연결을 등록합니다.
구문
PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnection(
[in] PDEVICE_OBJECT DeviceObject,
[in] PUNKNOWN FromUnknown,
[in] ULONG FromPin,
[in] PUNKNOWN ToUnknown,
[in] ULONG ToPin
);
매개 변수
[in] DeviceObject
어댑터 디바이스의 디바이스 개체에 대한 포인터입니다. 이 매개 변수는 DEVICE_OBJECT 형식의 시스템 구조를 가리킵니다.
[in] FromUnknown
포트 드라이버 개체의 IPort 인터페이스에 대한 포인터입니다. FromUnknown과 연결된 포트 드라이버 개체는 연결의 데이터 원본(출력) 핀을 제공하는 하위 서비스에 바인딩됩니다.
[in] FromPin
핀 ID를 지정합니다. 이 매개 변수는 FromUnknown 인터페이스와 연결된 필터의 원본(출력) 핀을 식별합니다.
[in] ToUnknown
포트 드라이버 개체의 IPort 인터페이스에 대한 포인터입니다. ToUnknown과 연결된 포트 드라이버 개체는 연결의 데이터 싱크(입력) 핀을 제공하는 하위 서비스에 바인딩됩니다.
[in] ToPin
핀 ID를 지정합니다. 이 매개 변수는 ToUnknown 인터페이스와 연결된 필터의 싱크(입력) 핀을 식별합니다.
반환 값
PcRegisterPhysicalConnection 은 호출에 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.
설명
어댑터 드라이버는 PcRegisterPhysicalConnection 을 호출하여 PortCls 시스템 드라이버에 물리적 연결을 등록합니다. PortCls는 포트 드라이버가 이후에 정보를 사용하여 KSPROPERTY_PIN_PHYSICALCONNECTION 속성 요청에 응답할 수 있도록 이 정보를 저장합니다.
호출자가 PcRegisterPhysicalConnection 함수에 제공하는 매개 변수는 동일한 어댑터 카드에서 두 하위 서비스(개별 필터로 표시됨) 간의 물리적 연결을 설명합니다.
소프트웨어 제어 하에서 구성할 수 있는 두 핀 간의 논리적 연결과 달리 실제 연결은 하드 연결됩니다. 예를 들어 일반적인 어댑터 카드는 웨이브 출력 필터의 출력 핀에서 토폴로지 필터의 입력 핀으로 아날로그 신호를 전달하는 실제 연결을 가질 수 있습니다.
PcRegisterPhysicalConnection 호출을 사용하여 어댑터의 물리적 연결을 등록하는 어댑터 드라이버의 디바이스 시작 루틴(시작 시퀀스 참조)의 예는 Microsoft WDK(Windows Driver Kit)의 SB16 샘플 오디오 드라이버에 대한 소스 코드를 참조하세요.
어댑터 드라이버는 IUnregisterPhysicalConnection::UnregisterPhysicalConnection 메서드를 호출하여 PcRegisterPhysicalConnection에 대한 이전 호출로 등록된 실제 연결의 등록을 삭제할 수 있습니다. 자세한 내용은 동적 오디오 하위 서비스를 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | PortCls 시스템 드라이버는 Microsoft Windows 98/Me 및 Windows 2000 이상 운영 체제에서 PcRegisterPhysicalConnection 함수를 구현합니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | portcls.h(Portcls.h 포함) |
| 라이브러리 | Portcls.lib |
| IRQL | PASSIVE_LEVEL |
참고 항목
IUnregisterPhysicalConnection::UnregisterPhysicalConnection
KSPROPERTY_PIN_PHYSICALCONNECTION
피드백
다음에 대한 사용자 의견 제출 및 보기