функция обратного вызова 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 (include Dispmprt.h) |
IRQL | PASSIVE_LEVEL |