KsInitializeDeviceProfile 함수(ks.h)

프로필 저장소를 초기화하고 디바이스 프로필을 게시하려면 모든 미니포트 드라이버에서 KsInitializeDeviceProfile API를 호출해야 합니다.

구문

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

매개 변수

[in] FilterFactory

카메라 드라이버가 카메라의 필터 팩터리를 고유하게 식별하기 위해 만든 KSFILTERFACTORY 입니다.

반환 값

제공된 KSFILTERFACTORY 에 KSCATEGORY_VIDEO_CAMERA 연결된 디바이스 인터페이스가 포함되어 있지 않으면 STATUS_INVALID_PARAMETER 이 API 호출이 실패합니다.

설명

KSFILTERFACTORY에 포함된 KSFILTER_DESCRIPTOR 구조체의 ReferenceGuid 필드를 이 필터 형식에 대한 고유한 GUID로 설정해야 합니다. 그리고 KSFILTER_DESCRIPTOR 플래그 필드에는 KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID 플래그가 설정됩니다.

이 KSFILTERFACTORY의 디바이스 인터페이스와 연결된 프로필 저장소에서 모든 프로필을 삭제하기 위해 드라이버는 KsInitializeDeviceProfile 을 호출한 다음 KsPersistDeviceProfile을 즉시 호출할 수 있습니다. 그러면 프로필 정보가 비어 프로필 저장소에서 프로필 정보가 제거됩니다.

요구 사항

대상 플랫폼	유니버설
헤더	ks.h(Ksmedia.h 포함)
라이브러리	Ks.lib