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

Artigo
02/26/2024

Um driver de miniporta de exibição no modo kernel chama DXGKCB_PINFRAMEBUFFERFORSAVE2 para fixar um buffer de quadro inteiro ao mesmo tempo.

Sintaxe

DXGKCB_PINFRAMEBUFFERFORSAVE2 DxgkcbPinframebufferforsave2;

NTSTATUS DxgkcbPinframebufferforsave2(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_PINFRAMEBUFFERFORSAVE2 pPinFrameBufferForSave2
)
{...}

Parâmetros

[in] hAdapter

Um identificador para um adaptador de exibição. O driver fornece esse identificador para o dispositivo main/cliente potencial na cadeia LDA (adaptador de vídeo vinculado).

[in/out] pPinFrameBufferForSave2

Ponteiro para uma estrutura DXGKARGCB_PINFRAMEBUFFERFORSAVE2 que contém informações sobre o buffer de quadros a ser salvo.

Retornar valor

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

Comentários

A implementação original do WDDM 2.4 IOMMU incluiu um par de funções de retorno de chamada para consultar a memória necessária para salvar o buffer de quadros. A área de salvamento do buffer de quadros foi criada como um objeto de seção durante a inicialização e o driver usou esses retornos de chamada para obter uma região mapeada de IOMMU quando necessário.

Os drivers que usam ADLs (listas de descritores de endereço) para dar suporte à remapeamento de DMA lógico implementam DXGKCB_PINFRAMEBUFFERFORSAVE2 em vez de DXGKARGCB_PINFRAMEBUFFERFORSAVE.

A memória fixada usando DXGKCB_PINFRAMEBUFFERFORSAVE2 pode ser desafixada usando o retorno de chamada de DXGKCB_UNPINFRAMEBUFFERFORSAVE original.

Confira Remapeamento de DMA 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_PINFRAMEBUFFERFORSAVE2 e, em seguida, chame DxgkCbPinFrameBufferForSave2 por meio do DXGKRNL_INTERFACE.