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 和更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 dispmprt.h (包括 Dispmprt.h)
IRQL PASSIVE_LEVEL

另请参阅

DxgkCbWriteDeviceSpace