функция обратного вызова 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 |