Función KsInitializeDeviceProfile (ks.h)

Todos los controladores de miniporte deben llamar a la API KsInitializeDeviceProfile para inicializar el almacén de perfiles y publicar los perfiles de dispositivo.

Sintaxis

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

Parámetros

[in] FilterFactory

Este es el KSFILTERFACTORY creado por el controlador de cámara para identificar de forma única el generador de filtros de la cámara.

Valor devuelto

Si el KSFILTERFACTORY proporcionado no contiene una interfaz de dispositivo asociada al KSCATEGORY_VIDEO_CAMERA, se producirá un error en esta llamada API con STATUS_INVALID_PARAMETER.

Comentarios

Es necesario que el campo ReferenceGuid de la estructura de KSFILTER_DESCRIPTOR incluida con KSFILTERFACTORY se establezca con un GUID único para este tipo de filtro. Y el campo Marcas del KSFILTER_DESCRIPTOR tiene establecida la marca KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID .

Para eliminar todos los perfiles del almacén de perfiles asociado a la interfaz del dispositivo para este KSFILTERFACTORY, el controlador puede llamar a KsInitializeDeviceProfile seguido inmediatamente por KsPersistDeviceProfile. Esto daría lugar a una información de perfil vacía, que quitaría la información de perfil del almacén de perfiles.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	ks.h (incluya Ksmedia.h)
Library	Ks.lib