다음을 통해 공유

FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE 콜백 함수(vmbuskernelmodeclientlibapi.h)

  • 아티클

[일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 명시적 또는 묵시적 보증을 하지 않습니다.]

VmbConvertVmbusHandleToKernelHandle 함수는 사용자 모드 VMBus 핸들을 커널 모드 핸들로 변환합니다.

구문

FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE FnVmbConvertVmbusHandleToKernelHandle;

NTSTATUS FnVmbConvertVmbusHandleToKernelHandle(
  HANDLE VmbusHandle,
  PHANDLE KernelHandle
)
{...}

매개 변수

VmbusHandle

변환할 사용자 모드 핸들입니다. 가상 머신 작업자 프로세스에서 열어야 합니다.

KernelHandle

VmbusHandle 값과 동일한 개체를 참조하는 커널 핸들입니다.

반환 값

작업이 성공하면 STATUS_SUCCESS 반환하고, 그렇지 않으면 적절한 NTSTATUS 오류 코드를 반환합니다.

설명

호출자는 커널 핸들을 닫습니다.

VmbusHandle 매개 변수는 사용자 모드 핸들이므로 VMBus 핸들을 연 사용자 모드 프로세스의 컨텍스트에서 이 함수를 호출해야 합니다.

이 함수를 호출하면 VmbServerChannelInitSetVmbusHandle 함수를 호출하는 경우가 많습니다.

중요

이 함수는 Vmbkmcl.sys 버스 드라이버에서 제공하는 KMCL(VMBus 커널 모드 클라이언트 라이브러리) 인터페이스를 통해 호출됩니다. KMCL_SERVER_ONLY_METHODS 구조에서 액세스하는 서버 전용 함수입니다.

자세한 내용은 KMCL_SERVER_ONLY_METHODS 설명 섹션을 참조 하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10, 버전 1803
머리글 vmbuskernelmodeclientlibapi.h

추가 정보

VmbServerChannelInitSetVmbusHandle