다음을 통해 공유

IHostTaskManager::CallNeedsHostHook 메서드

  • 아티클

호스트에서 CLR(공용 언어 런타임)이 관리되지 않는 함수에 대해 지정된 호출을 인라인할 수 있는지 여부를 지정할 수 있습니다.

구문

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

매개 변수

target
[in] 호출할 비관리형 함수의 매핑된 PE(이식 가능 실행) 파일 내의 주소입니다.

pbCallNeedsHostHook
[out] 호스트가 호출을 연결해야 하는지 여부를 나타내는 부울 값에 대한 포인터입니다.

Return Value

HRESULT 설명
S_OK CallNeedsHostHook가 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE CLR이 프로세스에 로드되지 않았거나 CLR이 관리 코드를 실행하거나 호출을 성공적으로 처리할 수 없는 상태입니다.
HOST_E_TIMEOUT 호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER 호출자는 잠금을 소유하지 않습니다.
HOST_E_ABANDONED 차단된 스레드 또는 파이버가 이벤트를 기다리는 동안 이벤트가 취소되었습니다.
E_FAIL 알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하면 CLR은 더 이상 프로세스 내에서 사용할 수 없습니다. 호스팅 메서드에 대한 후속 호출은 HOST_E_CLRNOTAVAILABLE을 반환합니다.

설명

코드 실행을 최적화하기 위해 CLR은 컴파일 중에 각 플랫폼 호출을 분석하여 호출을 인라인할 수 있는지 여부를 결정합니다. CallNeedsHostHook를 사용하면 호스트가 관리되지 않는 함수에 대한 호출을 후크하도록 요구하여 해당 결정을 재정의할 수 있습니다. 호스트에 후크가 필요한 경우 런타임은 호출을 인라인하지 않습니다.

호스트는 일반적으로 부동 소수점 상태를 조정해야 하는 후크가 필요하거나 호출이 호스트가 메모리에 대한 런타임 요청 또는 취해진 잠금을 추적할 수 없는 상태에 진입한다는 알림을 수신할 때 필요합니다. 호스트에서 호출을 연결해야 하는 경우 런타임은 EnterRuntime, LeaveRuntime, ReverseEnterRuntime, 및 ReverseLeaveRuntime을 사용하여 관리 코드로의 전환 호스트에 알릴 수 있습니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: MSCorEE.h

라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.

.NET Framework 버전: 2.0부터 사용 가능

참고 항목