Método IMFCameraControlDefaultsCollection::GetOrAddControl (mfidl.h)

Artigo
11/18/2024

Adiciona um novo controle de câmera à coleção de controle de câmera.

Sintaxe

HRESULT GetOrAddControl(
  MF_CAMERA_CONTROL_CONFIGURATION_TYPE configType,
  REFGUID                              controlSet,
  ULONG                                constrolId,
  ULONG                                controlSize,
  ULONG                                dataSize,
  IMFCameraControlDefaults             **defaults
);

Parâmetros

configType

Um valor do MF_CAMERA_CONTROL_CONFIGURATION_TYPE especificando se o valor do controle deve ser definido antes do início do streaming ou após o início do streaming.

controlSet

Um GUID que especifica o conjunto de controle ao qual o controle pertence. Se o controlSet for KSPROPERTYSETID_ExtendedCameraControl use a função de GetOrAddExtendedControl dedicada.

constrolId

A ID do controle a ser adicionado à coleção.

controlSize

O tamanho do controle, em bytes. Esse valor deve ser maior ou igual ao tamanho de KSPROPERTY.

dataSize

O tamanho da carga de dados para o controle, em bytes.

defaults

Recebe um ponteiro para uma instância IMFCameraControlDefaults que representa o controle adicionado.

Valor de retorno

Um HRESULT, incluindo o seguinte:

Valor	Descrição
S_OK	Êxito.

Observações

Para controles personalizados, controlSet e controlId são baseados no controle personalizado DDI publicado pelo fornecedor do driver de câmera. Da mesma forma, o controlSize e dataSize são baseados na DDI publicada pelo fornecedor.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Build 22621 do Windows 11
servidor com suporte mínimo	Build 22621 do Windows 11
cabeçalho	mfidl.h

Compartilhar via