DXGKCB_SAVEMEMORYFORHOTUPDATE función de devolución de llamada (d3dkmddi.h)

  • Artículo

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

Consulte también

DXGKARGCB_SAVEMEMORYFORHOTUPDATE

DXGKRNL_INTERFACE