BdaFilterFactoryUpdateCacheData 함수(bdasup.h)

아티클
02/26/2024

BdaFilterFactoryUpdateCacheData 함수는 필터의 instance 대한 핀 데이터 캐시를 업데이트합니다.

구문

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에 전달합니다. pFilterDescriptor가 NULL인 경우 pFilterFactory의 KSFILTER_DESCRIPTOR 멤버에 지정된 모든 핀 팩터리에 대해 캐시된 정보가 업데이트됩니다. 핀 데이터 캐시에 대한 자세한 내용은 DirectShow에 대한 고정 정보 캐싱을 참조하세요.

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