PFND3DDDI_ESCAPECB回调函数 (d3dumddi.h)
pfnEscapeCb 回调函数与显示微型端口驱动程序共享信息。
语法
PFND3DDDI_ESCAPECB Pfnd3dddiEscapecb;
HRESULT Pfnd3dddiEscapecb(
HANDLE hAdapter,
const D3DDDICB_ESCAPE *unnamedParam2
)
{...}
参数
hAdapter
图形适配器对象的句柄。
unnamedParam2
pData [in, out]
指向描述共享信息的 D3DDDICB_ESCAPE 结构的指针。
返回值
pfnEscapeCb 返回以下值之一:
返回代码 | 说明 |
---|---|
S_OK | 已成功共享信息。 |
E_OUTOFMEMORY | 由于内存不足,pfnEscapeCb 无法完成。 |
E_INVALIDARG | 参数已验证并确定不正确。 |
D3DDDIERR_DEVICEREMOVED | pfnEscapeCb 无法启动对显示微型端口驱动程序的 DxgkDdiEscape 函数的调用,因为发生了即插即用(PnP)停止或超时检测和恢复(TDR)事件。 调用 pfnEscapeCb 的用户模式显示驱动程序函数必须将此错误代码返回回 Direct3D 运行时。 Direct3D 版本 9 注意:有关返回错误代码的详细信息,请参阅 返回从运行时函数接收的错误代码。 Direct3D 版本 10 和 11 注意:如果驱动程序函数未返回值(即返回参数类型的 VOID),驱动程序函数将调用 pfnSetErrorCb 函数以将错误代码发送回运行时。 有关处理错误代码的详细信息,请参阅 处理错误。 |
此函数还可以返回其他 HRESULT 值。
言论
用户模式显示驱动程序调用 pfnEscapeCb,以任何其他驱动程序通信不支持的方式与显示微型端口驱动程序共享杂项信息。 用户模式显示驱动程序可以将其他信息发送到显示微型端口驱动程序,也可以从显示微型端口驱动程序中检索信息。
Direct3D 版本 11 注意:有关驱动程序如何调用 pfnEscapeCb的详细信息,请参阅 Direct3D 10 更改。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows Vista 和更高版本的 Windows作系统中可用。 |
目标平台 | 桌面 |
标头 | d3dumddi.h (包括 D3dumddi.h) |