Condividi tramite


Metodo IMFCameraControlDefaultsCollection::GetOrAddControl (mfidl.h)

Aggiunge un nuovo controllo fotocamera alla raccolta di controlli della fotocamera.

Sintassi

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

Parametri

configType

Valore del MF_CAMERA_CONTROL_CONFIGURATION_TYPE che specifica se il valore del controllo deve essere impostato prima dell'inizio del flusso o dopo l'avvio del flusso.

controlSet

GUID che specifica il set di controlli a cui appartiene il controllo. Se il controlSet è KSPROPERTYSETID_ExtendedCameraControl usare la funzione GetOrAddExtendedControl dedicata .

constrolId

ID del controllo da aggiungere alla raccolta.

controlSize

Dimensioni del controllo, in byte. Questo valore deve essere maggiore o uguale alla dimensione di KSPROPERTY.

dataSize

Dimensioni del payload dei dati per il controllo, in byte.

defaults

Riceve un puntatore a un IMFCameraControlDefaults'istanza che rappresenta il controllo aggiunto.

Valore restituito

HRESULT, incluso quanto segue:

Valore Descrizione
S_OK Successo.

Osservazioni

Per i controlli personalizzati, controlSet e controlId si basano sul DDI del controllo personalizzato pubblicato dal fornitore del driver della fotocamera. Analogamente, i controlSize e dataSize sono basati sull' DDI pubblicato dal fornitore.

Fabbisogno

Requisito Valore
client minimo supportato Windows 11 Build 22621
server minimo supportato Windows 11 Build 22621
intestazione mfidl.h