DXGKCB_AGP_SET_COMMAND回调函数 (dispmprt.h)
AgpSetCommand 函数设置 AGP 速率,并指定是否启用侧带寻址和快速写入事务。
语法
DXGKCB_AGP_SET_COMMAND DxgkcbAgpSetCommand;
NTSTATUS DxgkcbAgpSetCommand(
[in] HANDLE Context,
[in] ULONG Command
)
{...}
参数
[in] Context
与 AGP 接口关联的上下文块的句柄。 显示微型端口驱动程序之前在 DxgkCbQueryServices 填充的 DXGK_AGP_INTERFACE 结构的 Context 成员中收到此句柄。
[in] Command
一组标志,用于指定 AGP 速率和将使用的 AGP 事务类型。
调用方必须设置以下标志中的一个且只有一个。
标记 | 含义 |
---|---|
DXGK_AGPCOMMAND_AGP1X | AGP 传输速率为 1 倍。 |
DXGK_AGPCOMMAND_AGP2X | AGP 传输速率为 2 倍。 |
DXGK_AGPCOMMAND_AGP4X | AGP 传输速率为 4 倍。 |
DXGK_AGPCOMMAND_AGP8X | AGP 传输速率为 8X。 |
调用方还可以选择设置或清除以下标志。
标记 | 含义 |
---|---|
DXGK_AGPCOMMAND_DISABLE_SBA | 如果设置了此标志,则禁用侧带寻址。 如果清除此标志,则启用侧带寻址。 |
DXGK_AGPCOMMAND_DISABLE_FW | 如果设置了此标志,则会禁用快速写入事务。 如果清除此标志,则会启用快速写入事务。 请注意,快速写入事务不能与 AGP1X 一起使用。 |
返回值
如果成功,AgpSetCommand 将返回STATUS_SUCCESS。 否则,它将返回 Ntstatus.h 中定义的错误代码之一。
备注
无。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista |
目标平台 | 桌面 |
标头 | dispmprt.h (包括 Dispmprt.h) |
IRQL | PASSIVE_LEVEL |