확장 최소화

DxgkDdiGetStandardAllocationDriverData routine

The DxgkDdiGetStandardAllocationDriverData function returns a description of a standard allocation type.

Syntax


PDXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkDdiGetStandardAllocationDriverData;

NTSTATUS APIENTRY DxgkDdiGetStandardAllocationDriverData(
  _In_     const HANDLE hAdapter,
  _Inout_  DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA *pGetStandardAllocationDriverData
)
{ ... }

Parameters

hAdapter [in]

[in] A handle to a context block that is associated with a display adapter. The display miniport driver previously provided this handle to the Microsoft DirectX graphics kernel subsystem in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.

pGetStandardAllocationDriverData [in, out]

[in/out] A pointer to a DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA structure that describes a standard allocation.

Return value

DxgkDdiGetStandardAllocationDriverData returns one of the following values:

Return codeDescription
STATUS_SUCCESS

DxgkDdiGetStandardAllocationDriverData successfully returned a description of the standard allocation type.

STATUS_NO_MEMORY

DxgkDdiGetStandardAllocationDriverData could not allocate memory that was required for it to complete.

 

Remarks

Standard allocation types are allocations that must be created in kernel mode without communication from the user-mode display driver. The DirectX graphics kernel subsystem calls the DxgkDdiGetStandardAllocationDriverData function to generate a description of the standard allocation type that the pGetStandardAllocationDriverData parameter specifies. The display miniport driver returns the description of the allocation type in the pAllocationPrivateDriverData and pResourcePrivateDriverData members of the DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA structure that the pGetStandardAllocationDriverData parameter points to. The DirectX graphics kernel subsystem subsequently passes the description to the DxgkDdiCreateAllocation function to actually create the allocation.

Beginning with Windows 7, if a display miniport driver processes a call to the DxgkDdiGetStandardAllocationDriverData function to create allocations for GDI hardware acceleration, the driver should set the pitch of the allocation for CPU visible allocations, pGetStandardAllocationDriverData->pCreateGdiSurfaceData->Pitch.

DxgkDdiGetStandardAllocationDriverData should be made pageable.

Requirements

Version

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

Header

D3dkmddi.h (include D3dkmddi.h)

IRQL

PASSIVE_LEVEL

See also

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA
DxgkDdiAddDevice
DxgkDdiCreateAllocation

 

 

Send comments about this topic to Microsoft

표시:
© 2014 Microsoft