다음을 통해 공유

FN_VMB_CHANNEL_SAVE_CONTINUE 콜백 함수(vmbuskernelmodeclientlibapi.h)

  • 아티클

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

VmbChannelSaveContinue 함수는 채널 상태를 버퍼에 저장합니다. 이 함수를 실행하기 전에 VmbChannelSaveBegin 을 실행합니다. 드라이버는 함수의 반환 값을 검사 합니다.

구문

FN_VMB_CHANNEL_SAVE_CONTINUE FnVmbChannelSaveContinue;

NTSTATUS FnVmbChannelSaveContinue(
  VMBCHANNEL Channel,
  PVOID SaveBuffer,
  ULONG SaveBufferSize,
  PULONG BytesFilled,
  PULONG BytesRequired
)
{...}

매개 변수

Channel

저장할 채널에 대한 핸들입니다.

SaveBuffer

상태 정보를 저장할 버퍼에 대한 포인터입니다.

SaveBufferSize

저장 버퍼의 크기(바이트)입니다.

BytesFilled

저장 버퍼에 복사된 바이트 수를 수신하는 변수에 대한 포인터입니다.

BytesRequired

이 함수가 다음 호출에서 진행하는 데 필요한 바이트 수를 수신하는 변수에 대한 포인터입니다.

반환 값

VmbChannelSaveContinue 는 다음 값을 반환합니다.

반환 코드 설명
STATUS_SUCCESS
 상태가 저장되었습니다.
STATUS_BUFFER_TOO_SMALL
저장 버퍼가 너무 작습니다. BytesNeeded 매개 변수에는 진행에 필요한 바이트 수가 포함됩니다.
STATUS_STATUS_BUFFER_OVERFLOW
 일부 데이터는 저장 버퍼에 기록되었지만 저장할 데이터가 더 많습니다.

설명

저장 프로세스는 데이터를 "청크"로 저장하고 중지된 지점에서 계속할 수 있습니다.

호출자가 충분한 공간을 미리 할당하지 않은 경우 여러 호출이 필요할 수 있습니다.

중요

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

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

요구 사항

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

추가 정보

VmbChannelSaveBegin