DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT structure (d3dkmddi.h)
The DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT structure contains the information used by the DXGKCB_OPENPHYSICALMEMORYOBJECT callback function to open a physical memory object.
Syntax
typedef struct _DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT {
[in] HANDLE hPhysicalMemoryObject;
[in] HANDLE hAdapter;
[out] HANDLE hAdapterMemoryObject;
} DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT;
Members
[in] hPhysicalMemoryObject
The physical memory object handle that was returned from a call to DXGKCB_CREATEPHYSICALMEMORYOBJECT.
[in] hAdapter
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.
[out] hAdapterMemoryObject
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.
Requirements
Requirement | Value |
---|---|
Minimum supported server | Windows Server 2022 (WDDM 2.9) |
Header | d3dkmddi.h |