MFLockDXGIDeviceManager function (mfapi.h)

Locks the shared Microsoft DirectX Graphics Infrastructure (DXGI) Device Manager.

Syntax

HRESULT MFLockDXGIDeviceManager(
  [out] UINT                 *pResetToken,
  [out] IMFDXGIDeviceManager **ppManager
);

Parameters

[out] pResetToken

Receives a token that identifies this instance of the DXGI Device Manager. Use this token when calling IMFDXGIDeviceManager::ResetDevice. This parameter can be NULL.

[out] ppManager

Receives a pointer to the IMFDXGIDeviceManager interface. The caller must release the interface.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This function obtains a pointer to a DXGI Device Manager instance that can be shared between components. The Microsoft Media Foundation platform creates this instance of the DXGI Device Manager as a singleton object. Alternatively, you can create a new DXGI Device Manager by calling MFCreateDXGIDeviceManager.

The first time this function is called, the Media Foundation platform creates the shared DXGI Device Manager.

When you are done use the IMFDXGIDeviceManager pointer, call the MFUnlockDXGIDeviceManager.

Requirements

See also

MFCreateDXGIDeviceManager

Media Foundation Functions