Поделиться через


Функция KsInitializeDeviceProfile (ks.h)

API KsInitializeDeviceProfile должен вызываться всеми драйверами мини-порта для инициализации хранилища профилей и публикации профилей устройств.

Синтаксис

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

Параметры

[in] FilterFactory

Это KSFILTERFACTORY , созданный драйвером камеры для уникальной идентификации фабрики фильтров камеры.

Возвращаемое значение

Если предоставленный KSFILTERFACTORY не содержит интерфейс устройства, связанный с KSCATEGORY_VIDEO_CAMERA, вызов API завершится сбоем с STATUS_INVALID_PARAMETER.

Комментарии

Для поля ReferenceGuidструктуры KSFILTER_DESCRIPTOR , содержащей KSFILTERFACTORY , необходимо задать уникальный идентификатор GUID для этого типа фильтра. В поле ФлагиKSFILTER_DESCRIPTOR установлен флаг KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID .

Чтобы удалить все профили из хранилища профилей, связанного с интерфейсом устройства для этого KSFILTERFACTORY, драйвер может вызвать KsInitializeDeviceProfile , а затем сразу ksPersistDeviceProfile. Это приведет к пустой информации профиля, которая удалит данные профиля из хранилища профилей.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ks.h (включая Ksmedia.h)
Библиотека Ks.lib