Expand Minimize

DXGI1_1_DDI_BASE_FUNCTIONS structure

The DXGI1_1_DDI_BASE_FUNCTIONS structure contains pointers to functions that the user-mode display driver can implement to perform low-level tasks like presenting rendered frames to an output, controlling gamma, getting notifications regarding shared and GDI interoperable surfaces, and managing a full-screen transition.

Syntax


typedef struct DXGI1_1_DDI_BASE_FUNCTIONS {
  HRESULT (__stdcall *pfnPresent)(DXGI_DDI_ARG_PRESENT*);
  HRESULT (__stdcall *pfnGetGammaCaps)(DXGI_DDI_ARG_GET_GAMMA_CONTROL_CAPS*);
  HRESULT (__stdcall *pfnSetDisplayMode)(DXGI_DDI_ARG_SETDISPLAYMODE*);
  HRESULT (__stdcall *pfnSetResourcePriority)(DXGI_DDI_ARG_SETRESOURCEPRIORITY*);
  HRESULT (__stdcall *pfnQueryResourceResidency)(DXGI_DDI_ARG_QUERYRESOURCERESIDENCY*);
  HRESULT (__stdcall *pfnRotateResourceIdentities)(DXGI_DDI_ARG_ROTATE_RESOURCE_IDENTITIES*);
  HRESULT (__stdcall *pfnBlt)(DXGI_DDI_ARG_BLT*);
  HRESULT (__stdcall *pfnResolveSharedResource)(DXGI_DDI_ARG_RESOLVESHAREDRESOURCE*);
} DXGI1_1_DDI_BASE_FUNCTIONS;

Members

pfnPresent

A pointer to the driver's PresentDXGI function.

pfnGetGammaCaps

A pointer to the driver's GetGammaCapsDXGI function.

pfnSetDisplayMode

A pointer to the driver's SetDisplayModeDXGI function.

pfnSetResourcePriority

A pointer to the driver's SetResourcePriorityDXGI function.

pfnQueryResourceResidency

A pointer to the driver's QueryResourceResidencyDXGI function.

pfnRotateResourceIdentities

A pointer to the driver's RotateResourceIdentitiesDXGI function.

pfnBlt

A pointer to the driver's BltDXGI function.

pfnResolveSharedResource

A pointer to the driver's ResolveSharedResourceDXGI function.

Remarks

Windows 7 provides the IS_DXGI1_1_BASE_FUNCTIONS macro (which is defined in the D3D10umddi.h header file) to allow the user-mode display driver to determine whether it receives a pointer to a DXGI1_1_DDI_BASE_FUNCTIONS or DXGI_DDI_BASE_FUNCTIONS structure in a call to its CreateDevice(D3D10) function. The DXGI1_1_DDI_BASE_FUNCTIONS structure includes the pfnResolveSharedResource member that the driver can fill with a pointer to its ResolveSharedResourceDXGI function. If IS_DXGI1_1_BASE_FUNCTIONS returns TRUE, the driver expects to receive a pointer to a DXGI1_1_DDI_BASE_FUNCTIONS structure in the pDXGIDDIBaseFunctions member of the DXGI_DDI_BASE_ARGS structure that the DXGIBaseDDI member of the D3D10DDIARG_CREATEDEVICE structure specifies. Otherwise, if IS_DXGI1_1_BASE_FUNCTIONS returns FALSE, the driver expects to receive a pointer to a DXGI_DDI_BASE_FUNCTIONS structure. Windows 7 provides the IS_DXGI1_1_BASE_FUNCTIONS macro to allow newer version drivers to work on older version runtimes. The drivers can then determine whether they will corrupt memory if they attempt to fill the pfnResolveSharedResource member of DXGI1_1_DDI_BASE_FUNCTIONS with a pointer to a ResolveSharedResourceDXGI function.

Requirements

Version

DXGI1_1_DDI_BASE_FUNCTIONS is supported beginning with the Windows 7 operating system.

Header

Dxgiddi.h (include D3d10umddi.h)

See also

BltDXGI
CreateDevice(D3D10)
D3D10DDIARG_CREATEDEVICE
DXGI_DDI_BASE_ARGS
DXGI_DDI_BASE_FUNCTIONS
GetGammaCapsDXGI
PresentDXGI
QueryResourceResidencyDXGI
ResolveSharedResource
ResolveSharedResourceDXGI
RotateResourceIdentitiesDXGI
SetDisplayModeDXGI
SetResourcePriorityDXGI

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft