функция обратного вызова DXGKDDI_COLLECTDIAGNOSTICINFO (dispmprt.h)

Статья
07/16/2024

Подпрограмма обратного вызова DxgkDdiCollectDiagnosticInfo собирает сведения о частном драйвере по причинам, указанным DXGK_DIAGNOSTICINFO_TYPE.

В Windows 10 версии 1903 драйвер будет вызываться для сбора частной информации, если функция вызывает DxgkDdiAddDevice или DxgkDdiStartDevice.

Синтаксис

DXGKDDI_COLLECTDIAGNOSTICINFO DxgkddiCollectdiagnosticinfo;

NTSTATUS DxgkddiCollectdiagnosticinfo(
  [in]      IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
  [in, out] INOUT_PDXGKARG_COLLECTDIAGNOSTICINFO pCollectDiagnosticInfo
)
{...}

Параметры

[in] PhysicalDeviceObject

Указатель на объект физического устройства (PDO), определяющий адаптер дисплея.

[in, out] pCollectDiagnosticInfo

Указатель на структуру DXGKARG_COLLECTDIAGNOSTICINFO, которая описывает сведения, собранные драйвером.

Возвращаемое значение

Возвращает STATUS_SUCCESS, если частная информация была успешно собрана. В противном случае возвращается код ошибки, например один из следующих.

Код ошибки	Значение
STATUS_DRIVER_INTERNAL_ERROR	В драйвере произошла универсальная ошибка SW.
STATUS_ACCESS_DENIED	Оборудование в настоящее время используется другими потоками, и этот DDI не может получить к нему доступ.
STATUS_DEVICE_HARDWARE_ERROR	Произошла универсальная ошибка HW.
STATUS_DEVICE_POWERED_OFF	Устройство отключено.

Замечания

Эта функция вызывается на уровне PASSIVE в любое время между вызовами DxgkDdiAddDevice и DxgkDdiStartDeviceи должна поддерживать нулевых уровней синхронизации. Собранные данные не должны содержать никаких частных сведений о пользователе.

Драйверы WDDM 2.7 и более поздних версий необходимы для поддержки типа перечисления DXGK_DI_BLACKSCREENDXGK_DIAGNOSTICINFO_TYPE для сбора данных черного экрана.

В сценариях черного экрана ОС сначала собирает данные белого поля от драйвера, вызвав DxgkDdiGetDisplayStateNonIntrusive и DxgkDdiGetDisplayStateIntrusive перед вызовом этого DDI для сбора сведений о черном ящике.

Рекомендуется использовать pCollectDiagnosticInfo->BucketingStringString для сегментирования данных черного ящика по возможности. Если размер буфера BufferSizeIn не достаточно для всех данных черного ящика, драйверы должны сделать свои собственные компромиссы в выходе из данных, которые являются наименее важными в анализе первопричин черного экрана.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1903
заголовка	dispmprt.h
IRQL	PASSIVE_LEVEL

См. также

DXGKARG_COLLECTDIAGNOSTICINFO

DxgkDdiAddDevice

DxgkDdiStartDevice

Поделиться через