Freigeben über


DXGKCB_OPENPHYSICALMEMORYOBJECT Rückruffunktion (d3dkmddi.h)

Ein Kernelmodus-Miniporttreiber ruft DXGKCB_OPENPHYSICALMEMORYOBJECT auf, um ein physisches Speicherobjekt zu öffnen und es einem Adapter zuordnet.

Syntax

DXGKCB_OPENPHYSICALMEMORYOBJECT DxgkcbOpenphysicalmemoryobject;

NTSTATUS DxgkcbOpenphysicalmemoryobject(
  [in/out] IN_OUT_PDXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT pArgs
)
{...}

Parameter

[in/out] pArgs

Zeigen Sie auf eine DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT Struktur, die Informationen zum zu öffnenden physischen Speicherobjekt enthält.

Rückgabewert

DXGKCB_OPENPHYSICALMEMORYOBJECT gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Bemerkungen

Um eine Adressdeskriptorliste (ADL) aus einem physischen Speicherobjekt zu erstellen, muss sie zunächst einem Adapter zugeordnet werden. Dies geschieht normalerweise, wenn das physische Speicherobjekt erstellt wird, indem der hAdapter Parameter in einem Aufruf von DXGKCB_CREATEPHYSICALMEMORYOBJECTangegeben wird. In einigen Fällen ist der Adapterhandle jedoch zum Zeitpunkt der Zuweisung des Speichers nicht verfügbar (z. B. früh beim Startvorgang). In diesem Fall muss der Treiber DXGKCB_OPENPHYSICALMEMORYOBJECT aufrufen, um das physische Speicherobjekt einem Adapter zuzuordnen, bevor DXGKCB_ALLOCATEADLaufgerufen wird.

Weitere Informationen finden Sie unter IOMMU DMA-Neumapping.

DXGKCB_XXX Funktionen werden von Dxgkrnlimplementiert. Um diese Rückruffunktion zu verwenden, legen Sie die entsprechenden Member von DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT fest, und rufen Sie dann DxgkCbOpenPhysicalMemoryObject über die DXGKRNL_INTERFACEauf.

Anforderungen

Anforderung Wert
mindestens unterstützte Server- Windows Server 2022 (WDDM 2.9)
Header- d3dkmddi.h
IRQL- PASSIVE_LEVEL

Siehe auch

DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT

DXGKCB_ALLOCATEADL

DXGKCB_CLOSEPHYSICALMEMORYOBJECT

DXGKCB_CREATEPHYSICALMEMORYOBJECT