DXGKCB_WRITE_DEVICE_SPACE回调函数 (dispmprt.h)

  • 项目

DxgkCbWriteDeviceSpace 函数写入设备配置空间或显示适配器的扩展 ROM。

语法

DXGKCB_WRITE_DEVICE_SPACE DxgkcbWriteDeviceSpace;

NTSTATUS DxgkcbWriteDeviceSpace(
  [in]  HANDLE DeviceHandle,
  [in]  ULONG DataType,
  [in]  PVOID Buffer,
  [in]  ULONG Offset,
  [in]  ULONG Length,
  [out] PULONG BytesWritten
)
{...}

参数

[in] DeviceHandle

表示显示适配器的句柄。 显示微型端口驱动程序之前在传递给 DxgkDdiStartDevice 的 DXGKRNL_INTERFACE 结构的 DeviceHandle 成员中获取此句柄。

[in] DataType

要执行的写入事务的类型。 此参数必须是以下值之一，这些值在 Dispmprt.h 中定义：

DXGK_WHICHSPACE_BRIDGE

写入父总线设备的配置空间。

DXGK_WHICHSPACE_CONFIG

写入显示适配器的配置空间。

DXGK_WHICHSPACE_MCH

写入内存控制器中心的配置空间，该内存控制器中心是适配器的父总线的对等互连。

DXGK_WHICHSPACE_ROM

写入显示适配器的扩展 ROM。

[in] Buffer

指向缓冲区的指针，该缓冲区提供要写入配置空间的数据。

[in] Offset

写入事务开始处到配置空间的偏移量（以字节为单位）。

[in] Length

要写入的字节数。

[out] BytesWritten

指向 ULONG 类型变量的指针，该变量接收实际写入的字节数。

返回值

DxgkCbWriteDeviceSpace 返回以下值之一：

返回代码 说明
STATUS_SUCCESS 函数成功。
STATUS_INVALID_PARAMETER DeviceHandle、DataType 或 Buffer 参数无效。
STATUS_UNSUCCESSFUL 函数无法写入数据。

要求

要求 值
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
目标平台 桌面
标头 dispmprt.h (包括 Dispmprt.h)
IRQL PASSIVE_LEVEL

另请参阅

DxgkCbReadDeviceSpace