Expand Minimize

MF_TRANSFORM_ASYNC_UNLOCK attribute

Enables the use of an asynchronous Media Foundation transform (MFT).

Data type

UINT32

Get/set

To get this attribute, call IMFAttributes::GetUINT32.

To set this attribute, call IMFAttributes::SetUINT32.

Remarks

Asynchronous MFTs are not compatible with earlier versions of Microsoft Media Foundation. To prevent existing applications from accidentally using an asynchronous MFT, this attribute must be set to a nonzero value before an asynchronous MFT can be used. The Media Foundation pipeline automatically sets the attribute, so that most applications do not need to use this attribute. However, if an application uses an asynchronous MFT outside of the Media Foundation pipeline, the application must set this attribute.

Synchronous MFTs do not require this attribute.

To test whether an MFT is asynchronous, get the value of the MF_TRANSFORM_ASYNC attribute on the MFT.

Examples

The following code unlocks an asynchronous MFT.


HRESULT UnlockAsyncMFT(IMFTransform *pMFT)
{
    IMFAttributes *pAttributes = NULL;

    HRESULT hr = hr = pMFT->GetAttributes(&pAttributes);

    if (SUCCEEDED(hr))
    {
        hr = pAttributes->SetUINT32(MF_TRANSFORM_ASYNC_UNLOCK, TRUE);
        pAttributes->Release();
    }
    
    return hr;
}


Requirements

Minimum supported client

Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

Mftransform.h

See also

Asynchronous MFTs
Transform Attributes

 

 

Community Additions

ADD
Show:
© 2014 Microsoft