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

자세한 내용은 KMCL_SERVER_ONLY_METHODS주의 섹션을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 10 버전 1803
헤더	vmbuskernelmodeclientlibapi.h

참고 항목

VmbChannelSaveBegin