IHostTaskManager::CallNeedsHostHook 메서드

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(공용 언어 런타임)에서는 컴파일하는 동안 각 P/Invoke 호출을 분석하여 호출의 인라인 가능 여부를 결정합니다. 호스트는 CallNeedsHostHook를 통해 관리되지 않는 함수의 호출을 후크하도록 하여 해당 결정을 재정의할 수 있습니다. 호스트에 후크가 필요하면 런타임이 호출을 인라인하지 않습니다.

일반적으로 호스트에서 부동 소수점 상태를 조정해야 하는 경우 후크가 필요합니다. 또는 호스트에서 사용된 메모리나 잠금에 대한 런타임의 요청을 추적할 수 없는 호출 상태가 된다는 알림을 받을 때 후크가 필요합니다. 호스트에서 호출을 후크해야 하면 런타임에서 EnterRuntime, LeaveRuntime, ReverseEnterRuntime 및 ReverseLeaveRuntim 호출을 사용하여 관리 코드 전환을 호스트에 알립니다.