DXGKCB_OPENPHYSICALMEMORYOBJECT Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

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

Syntax

DXGKCB_OPENPHYSICALMEMORYOBJECT DxgkcbOpenphysicalmemoryobject;

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

Parameter

[in/out] pArgs

Zeiger 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.

Hinweise

Um eine Adressbeschreibungsliste (Address Descriptor List, ADL) aus einem physischen Speicherobjekt zu erstellen, muss sie zunächst einem Adapter zugeordnet werden. Dies geschieht normalerweise, wenn das objekt des physischen Arbeitsspeichers erstellt wird, indem der hAdapter-Parameter in einem Aufruf von DXGKCB_CREATEPHYSICALMEMORYOBJECT angegeben wird. In einigen Fällen ist das Adapterhandle jedoch nicht verfügbar, wenn der Arbeitsspeicher zugewiesen wurde (z. B. zu einem frühen Zeitpunkt des Startvorgangs). In diesem Fall muss der Treiber DXGKCB_OPENPHYSICALMEMORYOBJECT aufrufen, um das physische Speicherobjekt einem Adapter zuzuordnen, bevor DXGKCB_ALLOCATEADL aufgerufen wird.

Weitere Informationen finden Sie unter IOMMU DMA Remapping .

DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. 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_INTERFACE auf.