BdaPropertyTemplateConnections 함수(bdasup.h)

아티클
08/07/2023

BdaPropertyTemplateConnections 함수는 템플릿 토폴로지에서 핀 형식 및 노드 형식이 연결되는 방법을 설명하는 연결 목록을 검색합니다.

구문

NTSTATUS BdaPropertyTemplateConnections(
  [in]            PIRP                   pIrp,
  [in]            PKSPROPERTY            pKSProperty,
  [out, optional] PKSTOPOLOGY_CONNECTION pConnectionProperty
);

매개 변수

[in] pIrp

연결 목록을 검색하는 요청에 대한 IRP를 가리킵니다. BDA 미니드라이버가 KSPROPERTY_BDA_TEMPLATE_CONNECTIONS 요청과 함께 이 IRP를 받습니다.

[in] pKSProperty

속성 요청의 속성 및 요청 형식을 설명하는 KSPROPERTY 구조를 가리킵니다.

[out, optional] pConnectionProperty

템플릿 토폴로지의 연결을 설명하는 KSTOPOLOGY_CONNECTION 구조 목록을 수신하는 배열을 가리킵니다.

반환 값

STATUS_SUCCESS 또는 적절한 오류 코드를 반환합니다.

설명

BDA 미니드라이버가 네트워크 공급자로부터 설정된 KSPROPSETID_BdaTopology 속성의 KSPROPERTY_BDA_TEMPLATE_CONNECTIONS 요청을 받은 후 BdaPropertyTemplateConnections 함수를 호출하여 템플릿 연결 목록을 검색합니다. 대부분의 BDA 미니드라이버에서는 내부 get-handler(KStrGetPropertyHandler)를 사용하여 이 요청을 가로채지 않고 해당 미니드라이버가 BdaPropertyTemplateConnections 함수를 직접 디스패치하도록 디스패치 및 필터 자동화 테이블을 정의할 수 있습니다. 자세한 내용은 Automation 테이블 정의 및 BDA 디바이스 토폴로지 확인을 참조하세요.

BDA 미니드라이버가 BdaCreateFilterFactory 및 BdaInitFilter 함수 호출에서 BDA 필터 템플릿(BDA_FILTER_TEMPLATE)을 전달했을 때 BDA 미니드라이버가 BDA 지원 라이브러리에 대한 연결 목록을 KSTOPOLOGY_CONNECTION 구조 배열에 제공했습니다. 이 배열은 필터 내에서 또는 필터와 인접 필터 간에 만들 수 있는 노드와 핀 형식 간의 가능한 모든 연결을 나타내는 것입니다. BdaPropertyTemplateConnections 함수는 이 배열을 반환합니다.