DXGK_OPENALLOCATIONINFO structure (d3dkmddi.h)

The DXGK_OPENALLOCATIONINFO structure contains handles to nondevice-specific and device-specific allocations that the DxgkDdiOpenAllocation function associates.

Syntax

typedef struct _DXGK_OPENALLOCATIONINFO {
  [in]     D3DKMT_HANDLE hAllocation;
  [in/out] VOID          *pPrivateDriverData;
  [in]     UINT          PrivateDriverDataSize;
  [out]    HANDLE        hDeviceSpecificAllocation;
} DXGK_OPENALLOCATIONINFO;

Members

[in] hAllocation

A D3DKMT_HANDLE data type that represents a kernel-mode handle to the nondevice-specific allocation that the DxgkDdiCreateAllocation function created. The Microsoft DirectX graphics kernel subsystem (which is part of Dxgkrnl.sys) assigned this handle for the allocation.

[in/out] pPrivateDriverData

A pointer to a block of private data that is passed between the user-mode display driver and the display miniport driver. This block of private data is the same allocation-specific data that is passed in the pPrivateDriverData member of the DXGK_ALLOCATIONINFO structure in the call to the DxgkDdiCreateAllocation function. The display miniport driver's DxgkDdiOpenAllocation function can modify this block of private data if the Create bit-field flag is set in the Flags member of the DXGKARG_OPENALLOCATION structure. The user-mode display driver can access modifications to the block of private data.

[in] PrivateDriverDataSize

The size, in bytes, of the block of private data that pPrivateDriverData points to.

[out] hDeviceSpecificAllocation

A handle to the device-specific allocation that corresponds to the non device-specific allocation that hAllocation specifies. The display miniport driver must set hDeviceSpecificAllocation to a handle value that it can use to refer to its private tracking structure for the allocation.

Requirements

Requirement Value
Minimum supported client Windows Vista
Header d3dkmddi.h (include D3dkmddi.h)

See also

DXGKARG_OPENALLOCATION

DXGK_ALLOCATIONINFO

DxgkDdiCreateAllocation

DxgkDdiOpenAllocation