DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dkmddi.h
DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;
NTSTATUS DxgkddiGetstandardallocationdriverdata(
[in] IN_CONST_HANDLE hAdapter,
[in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The DxgkDdiGetStandardAllocationDriverData function returns a description of a standard allocation type.
hAdapter [in]A handle to a context block that is associated with a display adapter. The kernel-mode display driver (KMD) previously provided this handle to Dxgkrnl in its DxgkDdiAddDevice function.
pGetStandardAllocationDriverData [in/out]A pointer to aDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA structure that describes a standard allocation.
DxgkDdiGetStandardAllocationDriverData returns one of the following values:
| Return code | Description |
|---|---|
| STATUS_SUCCESS | DxgkDdiGetStandardAllocationDriverData successfully returned a description of the standard allocation type. |
| STATUS_NO_MEMORY | DxgkDdiGetStandardAllocationDriverData couldn't allocate memory that was required for it to complete. |
Standard allocation types are allocations that must be created in kernel mode without communication from the user-mode display driver.
Dxgkrnl calls the kernel mode driver's (KMD's) DxgkDdiGetStandardAllocationDriverData function to generate a description of the standard allocation type that the pGetStandardAllocationDriverData parameter specifies. KMD returns the description of the allocation type in the pAllocationPrivateDriverData and pResourcePrivateDriverData members of the DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA structure that the pGetStandardAllocationDriverData parameter points to. Dxgkrnl subsequently passes the description to the DxgkDdiCreateAllocation function to actually create the allocation.
Beginning with Windows 7, if KMD 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.
DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA