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

Статья
02/06/2025

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

Синтаксис

DXGKCB_READ_DEVICE_SPACE DxgkcbReadDeviceSpace;

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

Параметры

[in] DeviceHandle

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

[in] DataType

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

DXGK_WHICHSPACE_BRIDGE

Чтение из пространства конфигурации корневого порта PCI Express (PCIe).

DXGK_WHICHSPACE_CONFIG

Чтение из пространства конфигурации адаптера дисплея.

DXGK_WHICHSPACE_MCH

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

DXGK_WHICHSPACE_ROM

Чтение из РОМ расширения адаптера дисплея.

[in] Buffer

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

[in] Offset

Смещение в пространстве конфигурации или в диск расширения, с которого начинается транзакция чтения.

[in] Length

Число байтов для чтения.

[out] BytesRead

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

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

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

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

Требования

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

См. также

DxgkCbWriteDeviceSpace

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