BdaCreateFilterFactoryEx 함수(bdasup.h)

아티클
02/22/2024

BdaCreateFilterFactoryEx 함수는 지정된 필터 설명자를 필터 팩터리로 지정된 디바이스에 추가하고 필터 팩터리를 지정된 BDA 템플릿 토폴로지와 연결합니다.

구문

NTSTATUS BdaCreateFilterFactoryEx(
  [in]            PKSDEVICE                 pKSDevice,
  [in]            const KSFILTER_DESCRIPTOR *pFilterDescriptor,
  [in]            const BDA_FILTER_TEMPLATE *pBdaFilterTemplate,
  [out, optional] PKSFILTERFACTORY          *ppKSFilterFactory
);

매개 변수

[in] pKSDevice

연결된 BDA 템플릿 토폴로지를 사용하여 필터 팩터리를 추가할 BDA 디바이스를 가리킵니다.

[in] pFilterDescriptor

BDA 디바이스에 대한 필터를 설명하는 KSFILTER_DESCRIPTOR 구조를 가리킵니다. 필터가 처음 초기화될 때 모든 템플릿 핀 및 노드 형식이 핀 및 노드 팩터리로 노출될 수 있는 것은 아닙니다.

[in] pBdaFilterTemplate

BDA 템플릿 토폴로지를 설명하는 BDA_FILTER_TEMPLATE 구조를 가리킵니다.

[out, optional] ppKSFilterFactory

새로 만든 필터 팩터리에 대한 KSFILTERFACTORY 구조체에 대한 포인터를 받는 버퍼를 가리킵니다.

반환 값

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

설명

BDA 미니드라이버가 BdaCreateFilterFactoryEx 함수를 호출하여 연결된 BDA 템플릿 토폴로지를 사용하여 필터 팩터리를 디바이스에 추가하고 모든 토폴로지의 정적 템플릿 구조를 BDA 지원 라이브러리(BdaSup.sys)에 등록합니다. 그런 다음 BDA 지원 라이브러리는 다음 메서드 및 속성 호출을 처리할 수 있습니다.

BDA 미니드라이버는 새로 만든 KSFILTERFACTORY 에 대한 포인터가 필요할 때마다 BdaCreateFilterFactory 함수 대신 BdaCreateFilterFactoryEx 를 호출합니다. BdaCreateFilterFactory 함수도 필터 팩터리를 만들지만 호출자에게 반환하지는 않습니다. 미니드라이버가 KSFILTERFACTORY를 편집하기 위해 _KsEdit 함수를 호출해야 하는 경우 BDA 미니드라이버에는 새로 만든 KSFILTERFACTORY에 대한 포인터가 필요합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows XP 이상 운영 체제에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	bdasup.h(Bdasup.h 포함)
라이브러리	Bdasup.lib
IRQL	PASSIVE_LEVEL