DXGKCB_PINFRAMEBUFFERFORSAVE2 função de retorno de chamada (d3dkmddi.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Servidor mínimo com suporte | Windows Server 2022 (WDDM 2.9) |
| Cabeçalho | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |
Confira também
DXGKARGCB_PINFRAMEBUFFERFORSAVE2