Функция 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 (include Ksmedia.h)
библиотеки	Ks.lib