MFLockDXGIDeviceManager

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

Syntax

HRESULT MFLockDXGIDeviceManager(
         UINT *pResetToken,
         IMFDXGIDeviceManager **ppManager
)  

Parameters

pResetToken
Type: UINT *

[out, optional] Receives a token that identifies this instance of the Microsoft DirectX Graphics Infrastructure (DXGI) Device Manager. Use this token when calling IMFDXGIDeviceManager::ResetDevice. This parameter can be NULL.

ppManager
Type: IMFDXGIDeviceManager **

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

Return value

Type: HRESULT 

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

Refer to Media Foundation return codes.

Remarks

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

The first time this function is called, the Microsoft Media Foundation platform creates the shared Microsoft DirectX Graphics Infrastructure (DXGI) Device Manager.

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

Requirements

Header: Declared in mfapi.h.

Library: Use mfplat.lib.