DXGKCB_OPENPHYSICALMEMORYOBJECT função de retorno de chamada (d3dkmddi.h)

Artigo
02/23/2024

Um driver de miniporto de exibição no modo kernel chama DXGKCB_OPENPHYSICALMEMORYOBJECT para abrir um objeto de memória física e o associa a um adaptador.

Sintaxe

DXGKCB_OPENPHYSICALMEMORYOBJECT DxgkcbOpenphysicalmemoryobject;

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

Parâmetros

[in/out] pArgs

Ponteiro para uma estrutura DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT que contém informações sobre o objeto de memória física a ser aberto.

Retornar valor

DXGKCB_OPENPHYSICALMEMORYOBJECT retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retorna um código de erro NTSTATUS apropriado.

Comentários

Para criar uma ADL (lista de descritores de endereço) de um objeto de memória física, ele deve primeiro ser associado a um adaptador. Isso normalmente é feito quando o objeto de memória física é criado especificando o parâmetro hAdapter em uma chamada para DXGKCB_CREATEPHYSICALMEMORYOBJECT. No entanto, em alguns casos, o identificador do adaptador não está disponível no momento em que a memória foi alocada (por exemplo, no início do processo de inicialização). Nesse caso, o driver deve chamar DXGKCB_OPENPHYSICALMEMORYOBJECT para associar o objeto de memória física a um adaptador antes de chamar DXGKCB_ALLOCATEADL.

Consulte Remapeamento de DMA do IOMMU para obter mais informações.

DXGKCB_XXX funções são implementadas por Dxgkrnl. Para usar essa função de retorno de chamada, defina os membros apropriados do DXGKARGCB_OPEN_PHYSICAL_MEMORY_OBJECT e chame DxgkCbOpenPhysicalMemoryObject por meio do DXGKRNL_INTERFACE.