DXGKCB_OPENPHYSICALMEMORYOBJECT funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

Un driver miniport in modalità kernel chiama DXGKCB_OPENPHYSICALMEMORYOBJECT per aprire un oggetto di memoria fisica e associarlo a un adattatore.

Sintassi

DXGKCB_OPENPHYSICALMEMORYOBJECT DxgkcbOpenphysicalmemoryobject;

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

Parametri

[in/out] pArgs

Puntatore a una struttura DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT contenente informazioni sull'oggetto memoria fisica da aprire.

Valore restituito

DXGKCB_OPENPHYSICALMEMORYOBJECT restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituisce un codice di errore NTSTATUS appropriato.

Commenti

Per creare un elenco di descrittori di indirizzi (ADL) da un oggetto memoria fisica, deve prima essere associato a un adattatore. Questa operazione viene in genere eseguita quando viene creato l'oggetto memoria fisica specificando il parametro hAdapter in una chiamata a DXGKCB_CREATEPHYSICALMEMORYOBJECT. In alcuni casi, tuttavia, l'handle dell'adattatore non è disponibile al momento dell'allocazione della memoria , ad esempio all'inizio del processo di avvio. In questo caso, il driver deve chiamare DXGKCB_OPENPHYSICALMEMORYOBJECT per associare l'oggetto memoria fisica a un adattatore prima di chiamare DXGKCB_ALLOCATEADL.

Per altre informazioni, vedere Il mapping DMA di IOMMU .

DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, impostare i membri appropriati di DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT e quindi chiamare DxgkCbOpenPhysicalMemoryObject tramite il DXGKRNL_INTERFACE.