BdaInitFilter 함수(bdasup.h)

BdaInitFilter 함수는 필터 instance 연결된 BDA 필터 컨텍스트를 초기화합니다.

구문

NTSTATUS BdaInitFilter(
  [in] PKSFILTER                 pKSFilter,
  [in] const BDA_FILTER_TEMPLATE *pBdaFilterTemplate
);

매개 변수

[in] pKSFilter

BDA 필터 컨텍스트를 초기화할 필터를 가리킵니다.

[in] pBdaFilterTemplate

BDA 디바이스에 대한 필터 템플릿을 설명하는 BDA_FILTER_TEMPLATE 구조를 가리킵니다. 초기화된 필터에 대한 토폴로지를 확인하고 구성하기 위해 네트워크 공급자는 이 BDA_FILTER_TEMPLATE 구조에서 참조되는 정보를 사용합니다.

반환 값

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

설명

BDA 미니드라이버가 BdaInitFilter 함수를 호출하여 특정 BDA 필터 템플릿 및 BdaCreateFilterFactory 함수 호출을 통해 이전에 만든 필터 팩터리를 사용하여 필터의 instance 초기화합니다. BDA 미니 드라이버는 이후에 BdaCreatePin과 같은 다른 BDA 지원 함수에 대한 호출에서 이 필터 instance 사용할 수 있습니다.

BDA 미니드라이버가 BdaInitFilter를 호출하면 BDA 지원 드라이버(Bdasup.sys)가 자체 BDA 필터 컨텍스트를 만듭니다. 이 BDA 필터 컨텍스트는 BDA 미니 드라이버에서 숨겨집니다. 그러나 필요한 경우 BDA 지원 드라이버는 이 BDA 필터 컨텍스트에 액세스할 수 있습니다. BDA 지원 드라이버는 이 BDA 필터 컨텍스트에 대한 포인터를 연결된 KSFILTER 개체의 개체 모음에 추가합니다. 연결된 KSFILTER 개체가 제거되면 AVStream은 BDA 지원 드라이버가 개체 모음에서 이 BDA 필터 컨텍스트를 삭제할 것을 요청합니다. 이러한 방식으로 BDA 지원 드라이버는 BDA 미니드라이버의 개입 없이 이 BDA 필터 컨텍스트를 삭제할 수 있습니다.

요구 사항

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

추가 정보

BDA_FILTER_TEMPLATE

BdaCreateFilterFactory

BdaCreatePin

KSFILTER