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

Статья
02/26/2024

Функция 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 и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	dispmprt.h (включая Dispmprt.h)
IRQL	PASSIVE_LEVEL

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

DxgkCbReadDeviceSpace