Compartir a través de


MÉTODO IMFCameraControlDefaultsCollection::GetOrAddExtendedControl (mfidl.h)

Agrega un nuevo control de cámara extendido a la colección de controles de cámara.

Sintaxis

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

Valor de la MF_CAMERA_CONTROL_CONFIGURATION_TYPE especifica si el valor del control debe establecerse antes de que se inicie el streaming o después de que se inicie el streaming.

[in] constrolId

Identificador del control que se va a agregar a la colección. Este valor debe ser un identificador en el conjunto de propiedades KSPROPERTYSETID_ExtendedCameraControl .

[in] streamId

Identificador de la secuencia asociada al control . Este parámetro solo se usa para los controles de nivel de anclaje. De lo contrario, este valor se omite.

[in] dataSize

Tamaño de la carga de datos para el control, en bytes.

[out] defaults

Recibe un puntero a una instancia IMFCameraControlDefaults que representa el control agregado.

Valor devuelto

HrESULT, incluido lo siguiente:

Valor Descripción
S_OK Correcto.
MF_E_INVALIDREQUEST El identificador de control especificado no está en el conjunto de propiedades KSPROPERTYSETID_ExtendedCameraControl.

Comentarios

El tamaño de la carga de datos puede variar para distintos controles. El valor dataSize debe ser válido para el esquema de carga de control para que el control pueda reservar el búfer necesario.

Requisitos

Requisito Value
Cliente mínimo compatible compilación 22621 de Windows 11
Servidor mínimo compatible compilación 22621 de Windows 11
Encabezado mfidl.h