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

Dxgkrnl llama a DxgkDdiQueryDirtyBitData para solicitar una copia de los datos de plano de bits sucios del controlador de miniporte (KMD) de pantalla en modo kernel.

Sintaxis

DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;

NTSTATUS DxgkddiQuerydirtybitdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_QUERYDIRTYBITDATA pArgs
)
{...}

Parámetros

hAdapter

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

pArgs

[in/out] Puntero a una estructura de DXGKARG_QUERYDIRTYBITDATA que contiene información de entrada y salida para la consulta.

Valor devuelto

DxgkDdiQueryDirtyBitData devuelve STATUS_SUCCESS si la consulta se realizó correctamente. De lo contrario, devuelve un código de error NTSTATUS adecuado.

Comentarios

La función proporciona la base de memoria y los posibles identificadores de subrango para la información desfasada solicitada. KMD debe escribir los datos resultantes en el búfer de salida. DxgkDdiQueryDirtyBitData permite consultar todos los intervalos de la base de memoria o uno único.

Cuando la memoria esté disponible fácilmente, Dxgkrnl intentará acelerar esta operación mediante una sola llamada para consultar todos los datos necesarios a la vez. Sin embargo, en condiciones de memoria baja, es posible que se requiera un progreso hacia delante mediante un búfer de tamaño fijo más pequeño, que es solo un subconjunto más pequeño de la base de memoria que se realiza el seguimiento desde una llamada anterior a DdiStartDirtyTracking. El intervalo de plan de bits sucio solicitado nunca superará un rango sucio de seguimiento activo.

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

Requisitos

Consulte también

DXGKARG_QUERYDIRTYBITDATA