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


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

Функция 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 (включая Dispmprt.h)
IRQL PASSIVE_LEVEL

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

DxgkCbWriteDeviceSpace