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

Статья
02/06/2025

Функция DxgkCbWriteDeviceSpace записывает данные в пространство конфигурации устройства или расширение адаптера дисплея.

Синтаксис

DXGKCB_WRITE_DEVICE_SPACE DxgkcbWriteDeviceSpace;

NTSTATUS DxgkcbWriteDeviceSpace(
  [in]  HANDLE DeviceHandle,
  [in]  ULONG DataType,
  [in]  PVOID Buffer,
  [in]  ULONG Offset,
  [in]  ULONG Length,
  [out] PULONG BytesWritten
)
{...}

Параметры

[in] DeviceHandle

Дескриптор, представляющий адаптер отображения. Драйвер мини-порта дисплея ранее получил этот дескриптор в элементе deviceHandle элемента структуры DXGKRNL_INTERFACE, переданной DxgkDdiStartDevice.

[in] DataType

Тип выполняемой транзакции записи. Этот параметр должен быть одним из следующих значений, которые определены в Dispmprt.h:

DXGK_WHICHSPACE_BRIDGE

Запись в пространство конфигурации родительского устройства шины.

DXGK_WHICHSPACE_CONFIG

Запись в пространство конфигурации адаптера отображения.

DXGK_WHICHSPACE_MCH

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

DXGK_WHICHSPACE_ROM

Запись в диск расширения адаптера дисплея.

[in] Buffer

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

[in] Offset

Смещение в байтах в пространство конфигурации, с которого начинается транзакция записи.

[in] Length

Число записываемых байтов.

[out] BytesWritten

Указатель на переменную типа ULONG, которая получает количество байтов, фактически записанных.

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

DxgkCbWriteDeviceSpace возвращает одно из следующих значений:

Возвращаемый код	Описание
STATUS_SUCCESS	Функция завершилась успешно.
STATUS_INVALID_PARAMETER	Недопустимый параметр DeviceHandle, DataType или Buffer.
STATUS_UNSUCCESSFUL	Функция не смогла записать данные.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

См. также

DxgkCbReadDeviceSpace

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