D3DDDICB_SETDISPLAYMODE structure

The D3DDDICB_SETDISPLAYMODE structure describes the primary allocation that is used to scan out to the display.

Syntax


typedef struct _D3DDDICB_SETDISPLAYMODE {
  D3DKMT_HANDLE hPrimaryAllocation;
  UINT          PrivateDriverFormatAttribute;
} D3DDDICB_SETDISPLAYMODE;

Members

hPrimaryAllocation

[in] A D3DKMT_HANDLE data type that represents the kernel-mode handle to the primary allocation for scanning out. The Microsoft Direct3D runtime's pfnAllocateCb function returns this handle.

PrivateDriverFormatAttribute

[out] A private format attribute that the user-mode display driver should use to convert the current primary surface if the pfnSetDisplayModeCb callback function returned D3DDDIERR_INCOMPATIBLEPRIVATEFORMAT.

Remarks

The user-mode display driver can set the hPrimaryAllocation member in the call to pfnSetDisplayModeCb to scan out any allocation. However, the allocation must be marked as a primary (that is, the user-mode display driver must have set the Primary bit-field flag in the Flags member of the D3DDDI_ALLOCATIONINFO structure in a call to the pfnAllocateCb function to create the allocation).

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dumddi.h (include D3dumddi.h)

See also

D3DDDI_ALLOCATIONINFO
pfnAllocateCb
pfnSetDisplayModeCb

 

 

Send comments about this topic to Microsoft

Show: