Función KsInitializeDeviceProfile (ks.h)

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

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 la fábrica de filtros de la cámara.

Valor devuelto

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

Observaciones

Es necesario que el campo ReferenceGuid de la estructura de KSFILTER_DESCRIPTOR incluida con el KSFILTERFACTORY establecerse con un GUID único para este tipo de filtro. Y el campo Marcas de 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 de dispositivo de este KSFILTERFACTORY, el controlador puede llamar a KsInitializeDeviceProfile seguido inmediatamente de KsPersistDeviceProfile. Esto daría lugar a una información de perfil vacía, que quitaría la información del perfil del almacén de perfiles.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	ks.h (incluya Ksmedia.h)
biblioteca de	Ks.lib