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 |