DXGKCB_OPENPHYSICALMEMORYOBJECT - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dkmddi.h
DXGKCB_OPENPHYSICALMEMORYOBJECT DxgkcbOpenphysicalmemoryobject;
NTSTATUS DxgkcbOpenphysicalmemoryobject(
[in/out] IN_OUT_PDXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT pArgs
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
A kernel-mode display miniport driver calls DXGKCB_OPENPHYSICALMEMORYOBJECT to open a physical memory object and associates it with an adapter.
pArgs [in/out]Pointer to a DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT structure that contains information about the physical memory object to open.
DXGKCB_OPENPHYSICALMEMORYOBJECT returns STATUS_SUCCESS if the operation succeeds. Otherwise, returns an appropriate NTSTATUS error code.
In order to create an address descriptor list (ADL) from a physical memory object, it must first be associated with an adapter. This is normally done when the physical memory object is created by specifying the hAdapter parameter in a call to DXGKCB_CREATEPHYSICALMEMORYOBJECT. However, in some cases, the adapter handle is not available at the time the memory was allocated (for example, early in the boot process). In this case, the driver must call DXGKCB_OPENPHYSICALMEMORYOBJECT to associate the physical memory object with an adapter prior to calling DXGKCB_ALLOCATEADL.
See IOMMU DMA remapping for more information.
DXGKCB_XXX functions are implemented by Dxgkrnl. To use this callback function, set the appropriate members of DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT and then call DxgkCbOpenPhysicalMemoryObject via the DXGKRNL_INTERFACE.
DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT
DXGKCB_CLOSEPHYSICALMEMORYOBJECT
DXGKCB_CREATEPHYSICALMEMORYOBJECT