DXGKCB_READ_DEVICE_SPACE回调函数 （dispmprt.h）
DxgkCbReadDeviceSpace 函数从设备配置空间或显示适配器的扩展 ROM 读取。
语法
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
表示显示适配器的句柄。 显示微型端口驱动程序以前在 传递给 dxgkDdiStartDevice的 DXGKRNL_INTERFACE 结构的 DeviceHandle 成员中获取此句柄。
[in] DataType
要执行的读取事务的类型。 此参数必须是以下值之一，这些值在 Dispmprt.h中定义。
DXGK_WHICHSPACE_BRIDGE
从 PCI Express（PCIe）根端口的配置空间读取。
DXGK_WHICHSPACE_CONFIG
从显示适配器的配置空间中读取。
DXGK_WHICHSPACE_MCH
从内存控制器中心的配置空间读取，该中心是适配器的父总线的对等方。
DXGK_WHICHSPACE_ROM
从显示适配器的扩展 ROM 中读取。
[in] Buffer
指向调用方分配的缓冲区的指针，该缓冲区接收从配置空间或 ROM 读取的数据。
[in] Offset
偏移量，进入配置空间或扩展 ROM，从中开始读取事务。
[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 |