estrutura KSCAMERA_PROFILE_INFO (ksmedia.h)

A estrutura KSCAMERA_PROFILE_INFO é usada para identificar exclusivamente um determinado perfil.

Sintaxe

typedef struct _KSCAMERA_PROFILE_INFO {
  GUID                      ProfileId;
  UINT32                    Index;
  UINT32                    PinCount;
  PKSCAMERA_PROFILE_PININFO Pins;
} KSCAMERA_PROFILE_INFO, *PKSCAMERA_PROFILE_INFO;

Membros

ProfileId

GUID que representa uma ID exclusiva para o perfil. Esse GUID pode ser um GUID exclusivo criado por IHV/OEM que representa um perfil personalizado ou pode ser um GUID predefinido.

Esse campo não deve ser definido como KSCAMERAPROFILE_Legacy. O perfil herdado não deve ser publicado pelo driver da câmera. A ID do perfil herdado será enviada ao driver da câmera durante a inicialização do mecanismo de captura/captura de mídia se o aplicativo não tiver indicado que ele pode dar suporte a perfis.

Nesses casos, o driver da câmera deve reverter seu comportamento para o modo de operação Windows 8.1 e expor apenas os tipos de mídia de conjunto reduzido, juntamente com os KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_EXCLUSIVE_WITH_RECORD e KSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_SEQUENCE_EXCLUSIVE_WITH_RECORD correspondentes bits de funcionalidade que indicam se o driver da câmera é capaz de dar suporte à gravação/foto e/ou à sequência de gravação/foto simultânea dentro do tipo de mídia de conjunto reduzido.

Index

Cada perfil dentro de um determinado grupo ProfileId deve ter um valor de Índice exclusivo. Isso permite que qualquer perfil de um dispositivo seja identificado exclusivamente com o ProfileId + Index.

PinCount

O número de estruturas de KSCAMERA_PROFILE_PININFOapontadas por Pins. Esse valor deve ser maior que 0.

Pins

Uma matriz de estruturas KSCAMERA_PROFILE_PININFO definindo os tipos de mídia com suporte em cada um dos pinos desse perfil. Esse campo não deve ser NULL.

Requisitos

Requisito Valor
Cabeçalho ksmedia.h (inclua Ksmedia.h)