DXGKCB_SAVEMEMORYFORHOTUPDATE función de devolución de llamada (d3dkmddi.h)
Un controlador de miniporte de pantalla en modo kernel puede llamar a DXGKCB_SAVEMEMORYFORHOTUPDATE para guardar la memoria del adaptador para admitir la actualización activa del controlador.
Sintaxis
DXGKCB_SAVEMEMORYFORHOTUPDATE DxgkcbSavememoryforhotupdate;
NTSTATUS DxgkcbSavememoryforhotupdate(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARGCB_SAVEMEMORYFORHOTUPDATE pArgs
)
{...}
Parámetros
[in] hAdapter
Identificador del adaptador DXGK que se pasa a DxgkDdiStartDevice.
[in] pArgs
Puntero a la estructura DXGKARGCB_SAVEMEMORYFORHOTUPDATE que contiene argumentos para esta devolución de llamada.
Valor devuelto
DXGKCB_SAVEMEMORYFORHOTUPDATE devuelve STATUS_SUCCESS si la operación se realiza correctamente; de lo contrario, devuelve un código de error de Ntstatus.h.
Comentarios
Cada llamada a DXGKCB_SAVEMEMORYFORHOTUPDATE guarda un bloque de páginas de memoria física, así como metadatos opcionalmente que el controlador quiere asociar con el bloque de memoria. Cuando se restauran las páginas, el controlador obtendrá una llamada independiente para cada bloque de memoria guardado junto con los metadatos.
Para mayor comodidad, la devolución de llamada proporciona tres opciones para ahorrar memoria física:
- Como matriz de intervalos de memoria física contiguos (pDataMemoryRanges)
- Como MDL (pDataMdl)
- Como búfer de memoria virtual (pData)
Uno (y solo uno) de los punteros a los datos (pDataMemoryRanges, pDataMdl o pData) no debe ser NULL.
Dxgkrnl implementa DXGKCB_XXX funciones. Para usar esta función de devolución de llamada, establezca los miembros adecuados de DXGKARGCB_SAVEMEMORYFORHOTUPDATE y, a continuación, llame a DxgkCbSaveMemoryForHotUpdate a través del DXGKRNL_INTERFACE.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 1903 (WDDM 2.6) |
| Encabezado | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |