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 |
| 目标平台 | 桌面 |
| 标头 | dispmprt.h (包括 Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |