Edit

Share via

IMFExtendedCameraController interface (mfidl.h)

  • Article

Allows apps to retrieve an instance of IMFExtendedCameraControl, which is used to configure a capture device's extended properties.

Inheritance

The IMFExtendedCameraController interface inherits from the IUnknown interface.

Methods

The IMFExtendedCameraController interface has these methods.

 
IMFExtendedCameraController::GetExtendedCameraControl

Gets an instance of IMFExtendedCameraControl, which allows an app to get the current capture device's extended property controls.

Remarks

The IMFExtendedCameraController interface can be obtained through the IMFMediaSource that represents the video capture device and its IMFGetService implementation. In this case, guidService parameter of the IMFGetService::GetService function must be GUID_NULL, please see following code snippet.

HRESULT GetExtendedCameraController(_In_ IMFMediaSource cameraSource)
{
    wil::com_ptr_nothrow<IMFExtendedCameraController> extCameraController;
    wil::com_ptr_nothrow<IMFGetService> getService;

    RETURN_IF_FAILED(extCameraController.query_to(&getService));

    RETURN_IF_FAILED(getService->GetService(GUID_NULL, IID_PPV_ARGS(&extCameraController)));

    // Use the IMFExtendedCameraController

    return S_OK;
}

Requirements

Requirement Value
Minimum supported client Windows 10 Build 19041
Minimum supported server Windows 10 Build 19041
Header mfidl.h