Função KsInitializeDeviceProfile (ks.h)

A API KsInitializeDeviceProfile deve ser chamada por todos os drivers de miniport para inicializar o repositório de perfil e publicar os perfis de dispositivo.

Sintaxe

KSDDKAPI NTSTATUS KsInitializeDeviceProfile(
  [in] PKSFILTERFACTORY FilterFactory
);

Parâmetros

[in] FilterFactory

Este é o KSFILTERFACTORY que foi criado pelo driver da câmera para identificar exclusivamente a fábrica de filtros da câmera.

Retornar valor

Se o KSFILTERFACTORY fornecido não contiver uma interface de dispositivo associada ao KSCATEGORY_VIDEO_CAMERA, essa chamada à API falhará com STATUS_INVALID_PARAMETER.

Comentários

É necessário que o campo ReferenceGuid da estrutura KSFILTER_DESCRIPTOR contida com o KSFILTERFACTORY seja definido com um GUID exclusivo para esse tipo de filtro. E o campo Sinalizadores do KSFILTER_DESCRIPTOR tem o sinalizador KSFILTER_FLAG_PRIORITIZE_REFERENCEGUID definido.

Para excluir todos os perfis do repositório de perfil associados à interface do dispositivo para esse KSFILTERFACTORY, o driver pode chamar KsInitializeDeviceProfile seguido imediatamente por KsPersistDeviceProfile. Isso resultaria em informações de perfil vazias, o que removeria as informações de perfil do repositório de perfis.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	ks.h (inclua Ksmedia.h)
Biblioteca	Ks.lib