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

La función DxgkDdiCollectDbgInfo genera información del controlador para un informe de depuración.

Sintaxis

DXGKDDI_COLLECTDBGINFO DxgkddiCollectdbginfo;

NTSTATUS DxgkddiCollectdbginfo(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] IN_CONST_PDXGKARG_COLLECTDBGINFO pCollectDbgInfo
)
{...}

Parámetros

[in] hAdapter

Identificador de un bloque de contexto asociado a un adaptador de pantalla. El miniporte de pantalla (KMD) proporcionó anteriormente este identificador a Dxgkrnl en el parámetro de salida MiniportDeviceContext de DxgkDdiAddDevice.

[in/out] pCollectDbgInfo

Puntero a una estructura de DXGKARG_COLLECTDBGINFO que contiene información para el informe de depuración.

Valor devuelto

DxgkDdiCollectDbgInfo devuelve uno de los siguientes valores:

Comentarios

Dxgkrnl llama a la función DxgkDdiCollectDbgInfo de KMD cada vez que el sistema operativo está a punto de generar un informe de depuración relacionado con el controlador. Es posible que se llame a DxgkDdiCollectDbgInfo inmediatamente antes de que funcione la detección de tiempo de espera y la recuperación (TDR) o inmediatamente antes de las comprobaciones de errores del sistema operativo. Aunque DxgkDdiCollectDbgInfo debe devolver lo más rápido posible, no hay ninguna cantidad máxima de tiempo definida por el sistema que el controlador pueda dedicar en esta función.

KMD debe recopilar información de depuración. Cuando se llama a DxgkDdiCollectDbgInfo, el controlador recibe un código de comprobación de errores en pCollectDbgInfo-Reason> que indica el tipo de información necesaria para el informe de depuración. El controlador copia la información de depuración necesaria en el búfer al que apunta pCollectDbgInfo-pBuffer>. PCollectDbgInfo-BufferSize> especifica el número máximo de bytes de información que el controlador puede copiar.

DxgkDdiCollectDbgInfo se ejecuta generalmente en un IRQL indefinido. Sin embargo, si pCollectDbgInfo-Reason> está establecido en VIDEO_TDR_TIMEOUT_DETECTED (para indicar un restablecimiento de todo el adaptador) o VIDEO_ENGINE_TIMEOUT_DETECTED (disponible a partir de Windows 8 para indicar un restablecimiento de uno o varios nodos dentro de un adaptador físico), el controlador debe asegurarse de que DxgkDdiCollectDbgInfo es paginable, se ejecuta en IRQL = PASSIVE_LEVEL y admite el nivel cero de sincronización.

Requisitos

Consulte también

DXGKARG_COLLECTDBGINFO

DxgkDdiAddDevice

DxgkDdiResetFromTimeout