PcRegisterPhysicalConnectionFromExternal 함수(portcls.h)

아티클
08/07/2023

PcRegisterPhysicalConnectionFromExternal 함수는 외부 오디오 어댑터 필터에서 오디오 어댑터 필터에 대한 물리적 연결을 등록합니다.

구문

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnectionFromExternal(
  [in] PDEVICE_OBJECT  DeviceObject,
  [in] PUNICODE_STRING FromString,
  [in] ULONG           FromPin,
  [in] PUNKNOWN        ToUnknown,
  [in] ULONG           ToPin
);

매개 변수

[in] DeviceObject

디바이스의 디바이스 개체에 대한 포인터입니다. DEVICE_OBJECT 형식의 시스템 구조입니다.

[in] FromString

연결의 원본 핀을 제공하는 외부 필터의 기호 링크 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in] FromPin

핀 ID를 지정합니다. 이 매개 변수는 FromString에서 명명된 외부 필터의 원본(출력) 핀을 식별합니다.

[in] ToUnknown

포트 드라이버 개체의 IPort 인터페이스에 대한 포인터입니다. ToUnknown과 연결된 포트 드라이버 개체는 연결의 데이터 싱크(입력) 핀을 제공하는 하위 서비스에 바인딩됩니다.

[in] ToPin

핀 ID를 지정합니다. 이 매개 변수는 ToUnknown 인터페이스와 연결된 필터의 싱크(입력) 핀을 식별합니다.

반환 값

PcRegisterPhysicalConnectionFromExternal 은 호출이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.

설명

어댑터 드라이버는 PcRegisterPhysicalConnectionFromExternal 을 호출하여 PortCls 시스템 드라이버에 물리적 연결을 등록합니다. PortCls는 포트 드라이버가 이후에 정보를 사용하여 KSPROPERTY_PIN_PHYSICALCONNECTION 속성 요청에 응답할 수 있도록 이 정보를 저장합니다.

이 함수는 서로 다른 어댑터 드라이버에 의해 제어되는 두 오디오 어댑터 간에 토폴로지 링크를 지정하는 데 유용합니다. 함수는 로컬 오디오 어댑터의 하위 서비스를 나타내는 필터 개체와 외부 어댑터의 하위 서비스를 나타내는 필터 개체 간에 물리적 연결을 등록합니다.

FromString 매개 변수는 외부 어댑터 드라이버에 의해 노출되는 하위 서비스에 대한 기호 링크입니다.

외부 물리적 연결을 등록하는 데 필요한 정보는 두 드라이버에 제공해야 합니다. 이 작업은 두 디바이스의 초기 조정 설치 중에 수행하거나 두 디바이스의 구성에 대한 변경 내용을 조정하는 사용자 모드 구성 프로그램에서 동적으로 수행할 수 있습니다.

어댑터 드라이버는 IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal 메서드를 호출하여 PcRegisterPhysicalConnectionFromExternal에 대한 이전 호출로 등록된 실제 연결의 등록을 삭제할 수 있습니다. 자세한 내용은 동적 오디오 하위 서비스를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	PortCls 시스템 드라이버는 Microsoft Windows 98/Me 및 Windows 2000 이상 운영 체제에서 PcRegisterPhysicalConnectionFromExternal 함수를 구현합니다.
대상 플랫폼	유니버설
헤더	portcls.h(Portcls.h 포함)
라이브러리	Portcls.lib
IRQL	PASSIVE_LEVEL