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

  • Статья

Необязательная функция DxgkDdiLinkDevice запрашивает драйвер мини-порта дисплея для получения сведений о конфигурации связанного адаптера.

Синтаксис

DXGKDDI_LINK_DEVICE DxgkddiLinkDevice;

NTSTATUS DxgkddiLinkDevice(
  [in]      IN_CONST_PDEVICE_OBJECT PhysicalDeviceObject,
  [in]      IN_CONST_PVOID MiniportDeviceContext,
  [in, out] INOUT_PLINKED_DEVICE LinkedDevice
)
{...}

Параметры

[in] PhysicalDeviceObject

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

[in] MiniportDeviceContext

Дескриптор для блока контекста, связанного с видеоадаптером. Функция DxgkDdiAddevice драйвера мини-порта дисплея ранее предоставляла этот дескриптор подсистеме ядра графики Microsoft DirectX.

[in, out] LinkedDevice

Указатель на структуру LINKED_DEVICE , содержащую сведения о конфигурации связанного видеоадаптера.

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

DxgkDdiLinkDevice возвращает STATUS_SUCCESS или соответствующий код ошибки, если не удается получить сведения о конфигурации связанного адаптера.

Комментарии

Функция DxgkDdiLinkDevice должна быть реализована драйверами видеоадаптеров, которые поддерживают связанные видеоадаптеры.

Если эта функция указана, операционная система запросит драйвер минипорта дисплея для конфигурации связанного адаптера сразу после вызова DxgkDdiAddDevice.

Если операционная система не перечисляет все ожидаемые видеоадаптеры в структуре, на которую указывает LinkedDevice, система запустится в режиме VGA.

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

Plug and Play или события питания приводят к включению или запуску ведущего связанного адаптера после остальных связанных адаптеров, или, наоборот, такие события приводят к отключению питания или отключению ведущего связанного адаптера перед остальными связанными адаптерами.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть dispmprt.h
IRQL PASSIVE_LEVEL

См. также раздел

DxgkDdiAddDevice

LINKED_DEVICE