다음을 통해 공유

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA 콜백 함수(vmbuskernelmodeclientlibapi.h)

  • 아티클

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

VmbChannelInitSetMaximumExternalData 함수는 패킷에서 설명하지만 패킷에서 직접 전송되지는 않는 데이터의 최대 크기 및 체인 길이를 설정합니다. 즉, ExternalDataMdl에서 설명하는 버퍼의 최대 크기입니다.

구문

FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA FnVmbChannelInitSetMaximumExternalData;

NTSTATUS FnVmbChannelInitSetMaximumExternalData(
  VMBCHANNEL Channel,
  UINT32 DataSize,
  UINT32 ChainLength
)
{...}

매개 변수

Channel

KMCL(커널 모드 클라이언트 라이브러리) 채널에 대한 포인터입니다.

DataSize

외부 데이터의 최대 크기입니다.

ChainLength

들어오는 MDL 체인의 최대 메모리 설명자 Lists(MDL) 수입니다.

반환 값

VmbChannelInitSetMaximumExternalData는 다음 상태 값 중 하나를 반환할 수 있습니다.

반환 코드 설명
STATUS_SUCCESS
 함수가 성공적으로 완료되었습니다.
STATUS_INVALID_PARAMETER_1
 채널 값이 잘못되었거나 사용 안 함과 같은 잘못된 상태입니다.
STATUS_INVALID_PARAMETER_2
 DataSize 값이 잘못되었습니다. 0(0)이 잘못되었습니다.
STATUS_INVALID_PARAMETER_3
 ChainLength 값이 잘못되었습니다. 0(0)이 잘못되었습니다.

설명

KMCL은 링 버퍼가 지정된 제한에 버퍼가 포함된 패킷을 보낼 수 있을 만큼 충분히 큰지 확인합니다.

중요

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

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

요구 사항

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