KsFilterFactoryUpdateCacheData 함수(ks.h)

아티클
02/26/2024

KsFilterFactoryUpdateCacheData 함수는 지정된 필터 팩터리에 대한 FilterData 레지스트리 키 및 중간 캐시(레지스트리 키 집합)를 업데이트합니다.

구문

KSDDKAPI NTSTATUS KsFilterFactoryUpdateCacheData(
  [in]           PKSFILTERFACTORY          FilterFactory,
  [in, optional] const KSFILTER_DESCRIPTOR *FilterDescriptor
);

매개 변수

[in] FilterFactory

레지스트리에서 FilterData 및 Medium 캐시를 업데이트할 KSFILTERFACTORY 입니다.

[in, optional] FilterDescriptor

FilterData 키 및 중간 캐시를 업데이트할 선택적 KSFILTER_DESCRIPTOR . NULL이면 FilterFactory의 설명자가 대신 사용됩니다. 필터 팩터리에서 동적 핀을 사용하고 아직 인스턴스화되지 않은 핀에 대한 정보를 업데이트해야 하는 경우 를 제공합니다.

반환 값

KsFilterFactoryUpdateCacheData 는 관련 레지스트리 정보가 성공적으로 업데이트되었는지 여부를 나타내는 STATUS_SUCCESS 또는 오류 코드를 반환합니다. 필터 설명자에 전달된 범주에 해당하는 디바이스 인터페이스가 없으면 STATUS_INVALID_PARAMETER 반환합니다.

설명

이 함수는 FilterDescriptor에 지정된 모든 범주에 대해 FilterData 키 및 중간 캐시를 업데이트합니다. FilterDescriptor가 NULL이면 FilterFactory의 KSFILTER_DESCRIPTOR 멤버에 지정된 모든 범주에 대해 FilterData 및 Medium 캐시가 업데이트됩니다.

KsRegisterFilterWithNoKSPins는 비슷한 기능을 제공하지만 동일한 KSDEVICE에 있는 두 개의 KSFILTER_DESCRIPTOR 인스턴스가 동일한 범주에 등록되어 있고 참조 GUID에서만 다른 경우 사용하면 안 됩니다. 이 경우 KsRegisterFilterWithNoKSPins 는 두 번째 가 지정되었을 수 있더라도 첫 번째 데이터만 업데이트합니다.

아날로그 스타일 크로스바와 같이 KS 핀이 없는 필터에는 KsRegisterFilterWithNoKSPin 대신 이 루틴을 사용하지 마세요. 미니드라이버가 해당 필터 팩터리를 전달하는 특정 필터에 대해서만 이 루틴을 사용합니다.

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

자세한 내용은 AVStream 개체 계층 구조를 참조하세요.

KsFilterFactoryUpdateCacheData 함수는 PASSIVE_LEVEL 호출할 수 있습니다.