Função KsInitializeDeviceProfile (ks.h)

A API KsInitializeDeviceProfile deve ser chamada por todos os drivers de miniporto para inicializar o repositório de perfil e publicar os perfis do 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.

Valor de retorno

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

Observações

É necessário que o campo ReferenceGuid da estrutura KSFILTER_DESCRIPTOR contida no 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 deste 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 perfil.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ks.h (inclua Ksmedia.h)
biblioteca	Ks.lib