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

La función DxgkDdiStartDirtyTracking de KMD habilita el seguimiento de bits sucio dentro del segmento especificado y el intervalo de direcciones especificado.

Sintaxis

DXGKDDI_STARTDIRTYTRACKING DxgkddiStartdirtytracking;

NTSTATUS DxgkddiStartdirtytracking(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_HANDLE hMemoryBasis
)
{...}

Parámetros

hAdapter

[in] Identificador de un bloque de contexto asociado a un adaptador de pantalla. KMD proporcionó anteriormente este identificador a Dxgkrnl en el parámetro de salida MiniportDeviceContext de la función DxgiDdiAddDevice .

hMemoryBasis

[in] Controle la base de memoria sobre la que iniciar el seguimiento de operaciones desfasadas. KMD creó este identificador en una llamada anterior a DxgkDdiCreateMemoryBasis.

Valor devuelto

DxgkDdiStartDirtyTracking devuelve STATUS_SUCCESS tras el éxito. De lo contrario, devuelve un código NTSTATUS adecuado.

Comentarios

El controlador solo debe asegurarse de que el seguimiento sucio esté habilitado para la base de memoria especificada. Sin embargo, si lo hace en una granularidad general (por ejemplo, habilitar el seguimiento sucio para todo el adaptador o segmento) es válido siempre que se respeten todas las solicitudes pendientes.

Dxgkrnl puede habilitar el seguimiento de páginas sucias en varios segmentos o intervalos dentro de esos segmentos simultáneamente.

Cuando se habilita el seguimiento sucio, Dxgkrnl espera que el plano de bits sucio se inicialice en todos los ceros (todas las páginas sin modificar).

Para obtener más información, consulte Seguimiento de bits sucio.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 11, versión 24H2 (WDDM 3.2)
Encabezado	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Consulte también

DxgkDdiCreateMemoryBasis

DxgkDdiStopDirtyTracking