FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER 콜백 함수(vmbuskernelmodeclientlibapi.h)

  • 아티클

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

VmbChannelCreateGpadlFromBuffer 함수는 클라이언트 쪽 버퍼를 설명하는 GPADL(게스트 물리적 주소 설명자 목록)을 만듭니다. 서버에서 GPADL을 사용하여 버퍼에 액세스할 수 있습니다.

구문

FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER FnVmbChannelCreateGpadlFromBuffer;

NTSTATUS FnVmbChannelCreateGpadlFromBuffer(
  VMBCHANNEL Channel,
  UINT32 Flags,
  PVOID Buffer,
  UINT32 ByteCount,
  PUINT32 GpadlHandle
)
{...}

매개 변수

Channel

채널에 대한 핸들입니다.

Flags

플래그. 가능한 값은 다음과 같습니다.

값 의미
VMBUS_CHANNEL_GPADL_READ_ONLY
 이 값을 지정하면 버퍼는 읽기 전용입니다. 그렇지 않으면 서버가 버퍼에 쓸 수 있습니다. 이는 보안 조치가 아니지만 스냅샷 및 실시간 마이그레이션 성능을 향상시킬 수 있습니다.

Buffer

GPADL이 분해될 때까지 프로브되고 잠긴 버퍼입니다.

ByteCount

버퍼의 길이(바이트)입니다.

GpadlHandle

만든 MDL(메모리 설명자 목록)의 GPADL 핸들입니다. VmbChannelMapGpadl 함수와 함께 사용할 서버로 보냅니다.

반환 값

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

설명

이 함수가 반환되면 VMBus가 이미 GPADL 설명을 반대 엔드포인트로 보내고 확인을 받았기 때문에 서버 엔드포인트에서 VmbChannelMapGpadl을 호출할 수 있습니다.

VmbChannelDeleteGpadl 함수를 사용하여 GPADL을 삭제해야 합니다.

중요

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

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

요구 사항

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

추가 정보

VmbChannelDeleteGpadl

VmbChannelMapGpadl