Edit

Share via

DXVAHD_CreateDevice function (dxvahd.h)

  • Article

Creates a Microsoft DirectX Video Acceleration High Definition (DXVA-HD) device.

Syntax

HRESULT DXVAHD_CreateDevice(
  [in]  IDirect3DDevice9Ex        *pD3DDevice,
  [in]  const DXVAHD_CONTENT_DESC *pContentDesc,
  [in]  DXVAHD_DEVICE_USAGE       Usage,
  [in]  PDXVAHDSW_Plugin          pPlugin,
  [out] IDXVAHD_Device            **ppDevice
);

Parameters

[in] pD3DDevice

A pointer to the IDirect3DDevice9Ex interface of a Direct3D 9 device.

[in] pContentDesc

A pointer to a DXVAHD_CONTENT_DESC structure that describes the video content. The driver uses this information as a hint when it creates the device.

[in] Usage

A member of the DXVAHD_DEVICE_USAGE enumeration, describing how the device will be used. The value indicates the desired trade-off between speed and video quality. The driver uses this flag as a hint when it creates the device.

[in] pPlugin

A pointer to an initialization function for a software device. Set this pointer if you are using a software plug-in device. Otherwise, set this parameter to NULL. If the value is NULL, the driver creates the DXVA-HD device.

The function pointer type is PDXVAHDSW_Plugin.

[out] ppDevice

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

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
 The method succeeded.
E_NOINTERFACE
 The Direct3D device does not support DXVA-HD.

Remarks

Use the IDXVAHD_Device interface to get the device capabilities, create the video processor, and allocate video surfaces.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header dxvahd.h
Library Dxva2.lib
DLL Dxva2.dll

See also

Media Foundation Functions