estructura DXGKARG_COLLECTDIAGNOSTICINFO (dispmprt.h)

Artículo
02/06/2025

Usado por la función de devolución de llamada DXGKDDI_COLLECTDIAGNOSTICINFO para recopilar información del controlador privado por diversos motivos.

Por ejemplo, el sistema operativo llamará a la función de devolución de llamada DXGKDDI_COLLECTDIAGNOSTICINFO cuando se necesite información de diagnóstico, al tiempo que proporcionará el tipo de información que se solicita (DXGK_DIAGNOSTICINFO_TYPE). El controlador debe recopilar toda la información privada para investigar el problema y enviarlo al sistema operativo.

Sintaxis

typedef struct _DXGKARG_COLLECTDIAGNOSTICINFO {
  [in, optional]  HANDLE                   hAdapter;
  [in]            DXGK_DIAGNOSTICINFO_TYPE Type;
                  CHAR                     BucketingString[DXGK_DUMP_BUCKETING_BUFFER_SIZE];
                  CHAR                     DescriptionString[DXGK_DUMP_DESCRIPTION_BUFFER_SIZE];
  union {
    [out, optional] PVOID pReserved;
  };
  [in]            UINT                     BufferSizeIn;
  [out]           UINT                     BufferSizeOut;
  [out]           PVOID                    pBuffer;
} DXGKARG_COLLECTDIAGNOSTICINFO;

Miembros

[in, hAdapter

Identificador de un bloque de contexto asociado a un adaptador de pantalla.

Antes de WDDM 2.6, la función de dxgkDdiAddDevic e del controlador de minipuerto de pantalla proporcionó este identificador al subsistema del kernel de gráficos de DirectX. Este parámetro es opcional y puede ser NULL si el controlador no pudo proporcionar el identificador al sistema operativo.

[in] Type

Valor de enumeración DXGK_DIAGNOSTICINFO_TYPE que indica el tipo de información que el controlador debe recopilar.

[out] BucketingString[DXGK_DUMP_BUCKETING_BUFFER_SIZE]

Búfer de tamaño fijo proporcionado para una cadena que el controlador debe usar para identificar el problema con fines de depósito. Esta cadena debe ser coherente entre las versiones del controlador para el mismo problema, por lo que no debe contener elementos como referencias de origen, versiones de controlador o detalles específicos de la instancia, como números de barrera o identificadores de destino. Puede contener información como un identificador del subcomponente interno que produjo un error o el nombre de un módulo, por ejemplo, mismatched_driver_ihvxseries.sys. Los códigos válidos son 0x21-0x7E y el carácter de subrayado (0x5f) debe usarse en lugar del espacio (0x20).

[out, DescriptionString[DXGK_DUMP_DESCRIPTION_BUFFER_SIZE]

Un búfer de tamaño fijo proporcionado para una cadena que el controlador debe usar para describir detalles específicos de la instancia que no se usan para la creación de cubos, pero puede usarse para proporcionar más detalles sobre un problema específico, por ejemplo, mismatched_driver_versions_kmd_10.22.1111.1121,_ihvxseries:10.22.1111.1122. Los códigos válidos son 0x21-0x7E y el carácter de subrayado (0x5f) debe usarse en lugar del espacio (0x20).

[out, pReserved

Puntero a VOID en una unión sin nombre que está reservada como marcador de posición para un puntero a un argumento específico del tipo que el sistema operativo podría proporcionar para algunos tipos de . Este valor es NULL para Tipos que no requieren información extendida.

[in] BufferSizeIn

Variable que proporciona el tamaño, en bytes, del búfer asignado del sistema operativo. Para valor de tipo de DXGK_DI_ADDDEVICE y DXGK_DI_STARTDEVICE el tamaño estará alrededor de 0x80000.

[out] BufferSizeOut

Variable que el controlador debe actualizar con un tamaño real lleno de sus datos privados. Si no se proporciona ningún dato privado, el controlador debe asignar 0 a la variable .

[out] pBuffer

Puntero a un búfer que recibe los datos del controlador privado.