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

Um driver de miniporta de exibição no modo kernel pode chamar DXGKCB_SAVEMEMORYFORHOTUPDATE para salvar a memória do adaptador para dar suporte à atualização dinâmica do driver.

Sintaxe

DXGKCB_SAVEMEMORYFORHOTUPDATE DxgkcbSavememoryforhotupdate;

NTSTATUS DxgkcbSavememoryforhotupdate(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARGCB_SAVEMEMORYFORHOTUPDATE pArgs
)
{...}

Parâmetros

[in] hAdapter

Um identificador para o adaptador DXGK que é passado para DxgkDdiStartDevice.

[in] pArgs

Um ponteiro para a estrutura DXGKARGCB_SAVEMEMORYFORHOTUPDATE que contém argumentos para esse retorno de chamada.

Retornar valor

DXGKCB_SAVEMEMORYFORHOTUPDATE retornará STATUS_SUCCESS se a operação for bem-sucedida; caso contrário, retornará um código de erro de Ntstatus.h.

Comentários

Cada chamada para DXGKCB_SAVEMEMORYFORHOTUPDATE salva um bloco de páginas de memória física, bem como, opcionalmente, metadados que o driver deseja associar ao bloco de memória. Quando as páginas forem restauradas, o driver receberá uma chamada separada para cada bloco de memória salvo junto com metadados.

Para sua conveniência, o retorno de chamada fornece três opções para salvar a memória física:

• Como uma matriz de intervalos contíguos de memória física (pDataMemoryRanges)
• Como um MDL (pDataMdl)
• Como buffer de memória virtual (pData)

Um (e apenas um) dos ponteiros para dados (pDataMemoryRanges, pDataMdl ou pData) não deve ser NULL.

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

Requisitos

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

Confira também

DXGKARGCB_SAVEMEMORYFORHOTUPDATE

DXGKRNL_INTERFACE