BdaPropertyTemplateConnections 함수(bdasup.h)
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 함수는 이 배열을 반환합니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 데스크톱 |
머리글 | bdasup.h(Bdasup.h 포함) |
라이브러리 | Bdasup.lib |
IRQL | PASSIVE_LEVEL |