DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// d3dkmddi.h

typedef struct _DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT {
  [in]  HANDLE hPhysicalMemoryObject;
  [in]  HANDLE hAdapter;
  [out] HANDLE hAdapterMemoryObject;
} DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT;
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (ns-d3dkmddi-dxgkargcb_open_physical_memory_object)

Description

The DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT structure contains the information used by the DXGKCB_OPENPHYSICALMEMORYOBJECT callback function to open a physical memory object.

Members

hPhysicalMemoryObject [in]

The physical memory object handle that was returned from a call to DXGKCB_CREATEPHYSICALMEMORYOBJECT.

hAdapter [in]

A handle to any adapter that is part of the logical adapter to open the physical object against. This can be any physical adapter that is linked together in a linked display adapter (LDA) chain.

hAdapterMemoryObject [out]

Field in which a handle to the opened physical memory object for this adapter is returned.

Remarks

If the driver creates a physical memory object and specifies a non-NULL value for hAdapter in that call, then it must not call DxgkCbOpenPhysicalObject again. Doing so will return a failure indicating that the physical object is already opened against the adapter.

At this time, a physical memory object may only be opened by a single adapter. Attempting to open the object on a second adapter will fail.

Opening a physical memory object against one physical adapter is sufficient. This guarantees that all physical adapters in the logical adapter (all linked adapters) have a mirrored view of this memory.

See IOMMU DMA remapping for more information.

See also

DXGKCB_CREATEPHYSICALMEMORYOBJECT

DXGKCB_OPENPHYSICALMEMORYOBJECT