KsFilterFactoryUpdateCacheData 함수(ks.h)
KsFilterFactoryUpdateCacheData 함수는 지정된 필터 팩터리에 대해 FilterData 레지스트리 키 및 중간 캐시(레지스트리 키 집합)를 업데이트합니다.
통사론
KSDDKAPI NTSTATUS KsFilterFactoryUpdateCacheData(
[in] PKSFILTERFACTORY FilterFactory,
[in, optional] const KSFILTER_DESCRIPTOR *FilterDescriptor
);
매개 변수
[in] FilterFactory
KSFILTERFACTORY는 레지스트리에서 FilterData 및 Medium 캐시를 업데이트할.
[in, optional] FilterDescriptor
FilterData 키 및 중간 캐시를 업데이트할 선택적 KSFILTER_DESCRIPTOR. NULL 경우 FilterFactory설명자가 대신 사용됩니다. 필터 팩터리에서 동적 핀을 사용하고 아직 인스턴스화되지 않은 핀에 대한 정보를 업데이트해야 하는지를 제공합니다.
반환 값
KsFilterFactoryUpdateCacheData 관련 레지스트리 정보가 성공적으로 업데이트되었는지 여부를 나타내는 STATUS_SUCCESS 또는 오류 코드를 반환합니다. 필터 설명자에 전달된 범주에 해당하는 디바이스 인터페이스가 없는 경우 STATUS_INVALID_PARAMETER 반환합니다.
발언
이 함수는 FilterDescriptor지정된 모든 범주에 대해 FilterData 키 및 중간 캐시를 업데이트합니다. FilterDescriptor NULL 경우 filterData 및 Medium 캐시는 FilterFactoryKSFILTER_DESCRIPTOR 멤버에 지정된 모든 범주에 대해 업데이트됩니다.
KsRegisterFilterWithNoKSPins 유사한 기능을 제공하지만 동일한 KSDEVICE 아래의 두 KSFILTER_DESCRIPTOR 인스턴스가 동일한 범주에 등록되어 있고 참조 GUID에서만 다른 경우 사용하면 안 됩니다. 이 경우 KsRegisterFilterWithNoKSPins 두 번째가 지정되었을 수 있더라도 첫 번째 데이터만 업데이트합니다.
아날로그 스타일 크로스바와 같이 KS 핀이 없는 필터에는 KsRegisterFilterWithNoKSPins 대신 이 루틴을 사용하지 마세요. 미니 드라이버가 해당 필터 팩터리를 전달하는 특정 필터에 대해서만 이 루틴을 사용합니다.
또한 KsRegisterFilterWithNoKSPins 등록된 핀당 하나의 매체만 허용합니다. BDA 미니 드라이버로는 충분하지 않을 수 있습니다.
자세한 내용은 AVStream 개체 계층 구조참조하세요.
KsFilterFactoryUpdateCacheData 함수는 PASSIVE_LEVEL 호출할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 헤더 | ks.h(Ks.h 포함) |
| 라이브러리 | Ks.lib |