DXGKCB_OPENPHYSICALMEMORYOBJECT función de devolución de llamada (d3dkmddi.h)

Artículo
02/26/2024

Un controlador de miniporte de pantalla en modo kernel llama a DXGKCB_OPENPHYSICALMEMORYOBJECT para abrir un objeto de memoria física y lo asocia a un adaptador.

Sintaxis

DXGKCB_OPENPHYSICALMEMORYOBJECT DxgkcbOpenphysicalmemoryobject;

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

Parámetros

[in/out] pArgs

Puntero a una estructura de DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT que contiene información sobre el objeto de memoria física que se va a abrir.

Valor devuelto

DXGKCB_OPENPHYSICALMEMORYOBJECT devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error NTSTATUS adecuado.

Comentarios

Para crear una lista de descriptores de direcciones (ADL) a partir de un objeto de memoria física, primero debe asociarse a un adaptador. Normalmente, esto se hace cuando se crea el objeto de memoria física especificando el parámetro hAdapter en una llamada a DXGKCB_CREATEPHYSICALMEMORYOBJECT. Sin embargo, en algunos casos, el identificador del adaptador no está disponible en el momento en que se asignó la memoria (por ejemplo, al principio del proceso de arranque). En este caso, el controlador debe llamar a DXGKCB_OPENPHYSICALMEMORYOBJECT para asociar el objeto de memoria física a un adaptador antes de llamar a DXGKCB_ALLOCATEADL.

Consulte la reasignación de DMA de IOMMU para obtener más información.

DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, establezca los miembros adecuados de DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT y, a continuación, llame a DxgkCbOpenPhysicalMemoryObject a través del DXGKRNL_INTERFACE.