estrutura DXGKARGCB_SAVEMEMORYFORHOTUPDATE (d3dkmddi.h)

A estrutura DXGKARGCB_SAVEMEMORYFORHOTUPDATE contém as informações usadas pela função de retorno de chamada DXGKCB_SAVEMEMORYFORHOTUPDATE , para salvar a memória de uma atualização frequente do driver.

Sintaxe

typedef struct _DXGKARGCB_SAVEMEMORYFORHOTUPDATE {
  [in]           UINT                  NumDataMemoryRanges;
  [in, optional] DXGK_KSR_MEMORY_RANGE *pDataMemoryRanges;
  [in, optional] PMDL                  pDataMdl;
  [in]           UINT                  DataSize;
  [in, optional] PVOID                 pData;
  [in]           UINT                  MetaDataSize;
  [in, optional] BYTE                  *pMetaData;
} DXGKARGCB_SAVEMEMORYFORHOTUPDATE;

Membros

[in] NumDataMemoryRanges

O número de intervalos de memória física na matriz pDataMemoryRanges .

[in, pDataMemoryRanges

Ponteiro para a matriz de intervalos de memória física.

[in, pDataMdl

Ponteiro para uma MDL (lista de descritores de memória) que descreve as páginas de memória física.

Ao passar pDataMdl, o driver deve fazer o seguinte:

• Calcular a quantidade de memória a ser alocada
• MmAllocatePagesForMdlEx
• MmMapLockedPagesSpecifyCache
• Copiar a descrição dos dados para o buffer
• Copiar dados em páginas de estruturas de dados internas
• MmUnmapLockedPages
• Dar MDL a Dxgkrnl

[in] DataSize

O número de bytes no buffer para o qual pData aponta.

[in, pData

Um ponteiro para a memória virtual a ser salva.

[in] MetaDataSize

O número de bytes no buffer para o qual pMetaData aponta.

[in, pMetaData

O ponteiro de memória virtual para metadados associados ao bloco de memória salvo.

Comentários

O driver não deve salvar a mesma página física duas vezes.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1903 (WDDM 2.6)
Cabeçalho	d3dkmddi.h

Confira também

DXGKCB_SAVEMEMORYFORHOTUPDATE