IHostTaskManager::CallNeedsHostHook 方法

2008-08-18

更新：2007 年 11 月

允许宿主指定公共语言运行库 (CLR) 是否可以内联对非托管函数的指定调用。

HRESULT CallNeedsHostHook (
    [in]  SIZE_T target, 
    [out] BOOL   *pbCallNeedsHostHook
);

参数

target
[in] 要调用的非托管函数的已映射可移植可执行文件 (PE) 内的地址。
pbCallNeedsHostHook
[out] 一个指向布尔值的指针，该值指示宿主是否需要将调用挂钩。

返回值

HRESULT	说明
S_OK	CallNeedsHostHook 已成功返回。
HOST_E_CLRNOTAVAILABLE	CLR 尚未加载到进程中或者处于无法运行托管代码或成功处理调用的状态。
HOST_E_TIMEOUT	调用超时。
HOST_E_NOT_OWNER	调用方不拥有锁。
HOST_E_ABANDONED	事件在被阻止的线程或纤程正在等待它时被取消。
E_FAIL	发生了未知的灾难性故障。如果某方法返回 E_FAIL，CLR 便无法再在进程中使用。对宿主方法的后续调用都将返回 HOST_E_CLRNOTAVAILABLE。

备注

为了帮助优化代码执行，CLR 将在编译期间分析每个平台 invoke 调用，以确定是否可以内联调用。CallNeedsHostHook 允许宿主通过要求挂钩对非托管函数的调用来重写该决策。如果主机要求挂钩，则运行库不内联调用。

通常在宿主必须调整浮点状态或接收指明调用即将进入状态的通知（此时宿主无法跟踪运行库对使用的内存或任何锁的请求）时，宿主将要求挂钩。当宿主要求挂钩调用时，运行库会通过对 EnterRuntime、LeaveRuntime、ReverseEnterRuntime 和 ReverseLeaveRuntime 的调用通知宿主关于托管代码之间的转换。