Edit

IMFCameraConfigurationManager::LoadDefaults method (mfidl.h)

  • Article

Loads the camera control defaults for the specified capture source.

Syntax

HRESULT LoadDefaults(
  [in]  IMFAttributes                      *cameraAttributes,
  [out] IMFCameraControlDefaultsCollection **configurations
);

Parameters

[in] cameraAttributes

A pointer to an IMFAttributes in which the MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK attribute identifies the capture source for which default control values are retrieved.

[out] configurations

Receives a pointer to an IMFCameraControlDefaultsCollection object representing the collection of camera control default values.

Return value

An HRESULT, including the following:

Value Description
S_OK Success
MF_E_ATTRIBUTENOTFOUND The MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK attribute was not found in the IMFAttributes provided in cameraAttributes
MF_E_SHUTDOWN The function was called after IMFCameraConfigurationManager::Shutdown was called.

Remarks

If there are no default controls specified, the resulting collection will be empty. I.e. IMFCameraControlDefaultsCollection::GetControlCount will return 0.

Requirements

Requirement Value
Minimum supported client Windows 11 Build 22621
Minimum supported server Windows 11 Build 22621
Header mfidl.h