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

Статья
02/06/2025

Позволяет обмениваться очень простыми данными между ОС и драйвером, которые могут потребоваться до вызова устройства DxgkDdiStartDevice и поэтому не могут запрашиваться через обычные крышки или идентификаторы данных адаптера.

Синтаксис

DXGKDDI_EXCHANGEPRESTARTINFO DxgkddiExchangeprestartinfo;

NTSTATUS DxgkddiExchangeprestartinfo(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_OUT_PDXGK_PRE_START_INFO pPreStartInfo
)
{...}

Параметры

[in] hAdapter

Определяет адаптер.

[in] pPreStartInfo

Указатель на структуру DXGK_PRE_START_INFO, которая содержит оба поля для операционной системы для передачи сведений и полей драйвера для возврата сведений. Изначально определяется только SupportPreserveBootDisplay.

[out] SupportPreserveBootDisplay

Драйвер и оборудование поддерживают требования, позволяющие использовать и отображать буфер загрузочного кадра во время инициализации оборудования, выполняемого во время DxgkDdiStartDevice.

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

Если эта подпрограмма завершается успешно и возвращает запрошенное изменение, он возвращает STATUS_SUCCESS.

Замечания

Этот DDI будет вызываться после DxgkDdiAddDevice и до DxgkDdiStartDevice, чтобы драйвер не имеет доступа к собственным аппаратным ресурсам. Однако он может использовать PhysicalDeviceObject, переданный драйверу в DxgkDdiAddDevice для вызова IoGetDeviceProperty. Например, он может найти идентификатор оборудования, чтобы решить, что возвращать в выходных полях структуры DXGK_PRE_START_INFO.

Эта функция всегда вызывается на уровне PASSIVE, поэтому вспомогательный код должен быть доступен для страниц по возможности.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dispmprt.h

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