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

另请参阅

AgpAllocatePool

AgpFreePool

DXGK_AGP_INTERFACE

DxgkCbQueryServices