Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

MF_SA_D3D_AWARE attribute

Specifies whether a Media Foundation transform (MFT) supports DirectX Video Acceleration (DXVA). This attribute applies only to video MFTs.

Data type

BOOL stored as UINT32

Remarks

To query this attribute, call IMFTransform::GetAttributes to get the global attribute store of the MFT. If GetAttributes succeeds, call IMFAttributes::GetUINT32.

This attribute tells the client whether the MFT can use Direct3D 9 video:

  • If the attribute is nonzero, the client can give the MFT a pointer to the IDirect3DDeviceManager9 interface before streaming starts. To do so, the client sends the MFT_MESSAGE_SET_D3D_MANAGER message to the MFT. The client is not required to send this message.
  • If this attribute is zero (FALSE), the MFT does not support Direct3D 9 video, and the client should not send the MFT_MESSAGE_SET_D3D_MANAGER message to the MFT.

The default value of this attribute is FALSE. Treat this attribute as read-only. Do not change the value; the MFT will ignore any changes to the value.

For more information about implementing this attribute in a custom MFT, see Direct3D-Aware MFTs.

The GUID constant for this attribute is exported from mfuuid.lib.

Examples

The following code tests whether an MFT supports DXVA.


// Returns TRUE is an MFT supports DirectX Video Acceleration.

BOOL IsTransformD3DAware(IMFTransform *pMFT)
{
    BOOL bD3DAware = FALSE;
    
    IMFAttributes *pAttributes = NULL;

    HRESULT hr = pMFT->GetAttributes(&pAttributes);
    if (SUCCEEDED(hr))
    {
        bD3DAware = MFGetAttributeUINT32(pAttributes, MF_SA_D3D_AWARE, FALSE);
        pAttributes->Release();
    }
    return bD3DAware;
}


Requirements

Minimum supported client

Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 [desktop apps | Windows Store apps]

Header

Mftransform.h

See also

Alphabetical List of Media Foundation Attributes
Direct3D-Aware MFTs
Supporting DXVA 2.0 in Media Foundation
Media Foundation Transforms
Transform Attributes
IMFAttributes::GetUINT32
IMFAttributes::SetUINT32
MF_TOPOLOGY_DXVA_MODE

 

 

Show:
© 2017 Microsoft