DXGKCB_READ_DEVICE_SPACE回调函数 (dispmprt.h)

项目
05/23/2024

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

另请参阅

DxgkCbWriteDeviceSpace

通过