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을 즉시 호출할 수 있습니다. 이렇게 하면 프로필 정보가 비어 있으므로 프로필 저장소에서 프로필 정보가 제거됩니다.

요구 사항