Compartilhar via

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

  • Artigo

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

Sintaxe

HRESULT GetOrAddExtendedControl(
  [in]  MF_CAMERA_CONTROL_CONFIGURATION_TYPE configType,
  [in]  ULONG                                constrolId,
  [in]  DWORD                                streamId,
  [in]  ULONG                                dataSize,
  [out] IMFCameraControlDefaults             **defaults
);

Parâmetros

[in] 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.

[in] constrolId

A ID do controle a ser adicionado à coleção. Esse valor deve ser uma ID no conjunto de propriedades KSPROPERTYSETID_ExtendedCameraControl .

[in] streamId

A ID do fluxo associado ao controle . Esse paramater só é usado para controles de nível de pin. Caso contrário, esse valor será ignorado.

[in] dataSize

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

[out] defaults

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

Retornar valor

Um HRESULT, incluindo o seguinte:

Valor Descrição
S_OK Êxito.
MF_E_INVALIDREQUEST A ID de controle especificada não está no conjunto de propriedades KSPROPERTYSETID_ExtendedCameraControl.

Comentários

O tamanho da carga de dados pode variar para controles diferentes. O valor dataSize deve ser válido para o esquema de carga de controle para que o controle possa reservar o buffer necessário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 11 Build 22621
Servidor mínimo com suporte Windows 11 Build 22621
Cabeçalho mfidl.h