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

Статья
08/07/2023

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

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

DxgkCbWriteDeviceSpace