BdaFilterFactoryUpdateCacheData 함수(bdasup.h)

BdaFilterFactoryUpdateCacheData 함수는 필터 인스턴스에 대한 핀 데이터 캐시를 업데이트합니다.

구문

NTSTATUS BdaFilterFactoryUpdateCacheData(
  [in]           PKSFILTERFACTORY          pFilterFactory,
  [in, optional] const KSFILTER_DESCRIPTOR *pFilterDescriptor
);

매개 변수

[in] pFilterFactory

핀 데이터 캐시를 업데이트할 KSFILTERFACTORY 를 가리킵니다.

[in, optional] pFilterDescriptor

핀 데이터 캐시가 업데이트될 선택적 KSFILTER_DESCRIPTOR 가리킵니다. NULL 인 경우 pFilterFactory 의 설명자가 대신 사용됩니다. 이 매개 변수를 사용하면 동적 핀 만들기, 즉 필터의 디스패치 만들기 루틴이 완료된 후에 발생하는 핀 만들기를 사용할 수 있습니다.

반환 값

STATUS_SUCCESS 또는 적절한 오류 코드를 반환합니다. 필터 설명자에 전달된 범주에 해당하는 디바이스 인터페이스가 없으면 STATUS_INVALID_PARAMETER 반환합니다.

설명

BDA 미니 드라이버는 BdaFilterFactoryUpdateCacheData 함수를 호출하여 pFilterDescriptor 에 지정된 모든 핀에 대한 핀 데이터 캐시를 업데이트합니다. 이 호출에서 BDA 미니 드라이버는 일반적으로 BDA 필터에 대한 템플릿 토폴로지를 설명하는 BDA_FILTER_TEMPLATE 구조체의 pFilterDescriptor 멤버를 pFilterDescriptor 에 전달합니다. pFilterDescriptorNULL 이면 pFilterFactory 의 KSFILTER_DESCRIPTOR 멤버에 지정된 모든 핀 팩터리에 대해 캐시된 정보가 업데이트됩니다. 핀 데이터 캐시에 대한 자세한 내용은 DirectShow에 대한 핀 정보 캐싱을 참조하세요.

KsRegisterFilterWithNoKSPins 함수는 유사한 기능을 제공하지만 등록된 핀당 하나의 매체만 허용합니다. 이는 BDA 미니 드라이버에 충분하지 않을 수 있습니다.

요구 사항

   
대상 플랫폼 데스크톱
헤더 bdasup.h(Bdasup.h 포함)
라이브러리 Bdasup.lib
IRQL PASSIVE_LEVEL

참고 항목

BDA_FILTER_TEMPLATE

KSFILTERFACTORY

KSFILTER_DESCRIPTOR

KsRegisterFilterWithNoKSPins