Condividi tramite


Metodo IMFCameraControlDefaultsCollection::GetOrAddExtendedControl (mfidl.h)

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

Sintassi

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

Parametri

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

[in] constrolId

ID del controllo da aggiungere alla raccolta. Questo valore deve essere un ID nel set di proprietà KSPROPERTYSETID_ExtendedCameraControl .

[in] streamId

ID del flusso associato al controllo . Questo paramater viene usato solo per i controlli a livello di pin. In caso contrario, questo valore viene ignorato.

[in] dataSize

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

[out] defaults

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

Valore restituito

HRESULT, tra cui quanto segue:

Valore Descrizione
S_OK Operazione completata.
MF_E_INVALIDREQUEST L'ID di controllo specificato non si trova nel set di proprietà KSPROPERTYSETID_ExtendedCameraControl.

Commenti

Le dimensioni del payload dei dati possono variare per i diversi controlli. Il valore dataSize deve essere valido per lo schema del payload del controllo in modo che il controllo possa riservare il buffer necessario.

Requisiti

Requisito Valore
Client minimo supportato Windows 11 Build 22621
Server minimo supportato Windows 11 Build 22621
Intestazione mfidl.h