Share via

FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES 콜백 함수(vmbuskernelmodeclientlibapi.h)

  • 아티클

VmbServerChannelInitSetMmioMegabytes 함수는 디바이스에 예약할 게스트 메모리 매핑 I/O(I/O) 공간의 양(메가바이트)을 지정합니다.

구문

FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES FnVmbServerChannelInitSetMmioMegabytes;

NTSTATUS FnVmbServerChannelInitSetMmioMegabytes(
  VMBCHANNEL Channel,
  UINT16 MmioMegabytes,
  UINT16 MmioMegabytesOptional
)
{...}

매개 변수

Channel

채널에 대한 핸들입니다.

MmioMegabytes

예약할 MMIO 공간의 양(메가바이트)입니다.

MmioMegabytesOptional

예약할 추가 선택적 MMIO 공간(메가바이트)입니다.

반환 값

VmbServerChannelInitSetMmioMegabytes는 다음 상태 값을 반환합니다.

반환 코드 설명
STATUS_INVALID_PARAMETER_1
 채널 값이 잘못되었거나 사용 안 함과 같은 잘못된 상태입니다.
STATUS_INVALID_PARAMETER
 MmioMegabytes 및 MmioMegabytesOptional의 값은 0입니다. 이러한 매개 변수 중 하나가 0보다 커야 합니다.

설명

이 함수는 드라이버 작성자의 편의를 위해 존재합니다. 게스트 플러그 앤 플레이 관리자와 상호 작용하고 메모리 매핑된 I/O 공간을 직접 요청하여 모든 작업을 수행할 수 있습니다. Windows 및 Linux VMBus 드라이버에는 클라이언트를 대신하여 MMIO 공간을 예약할 수 있는 용량이 있어야 하는 일반적인 요구 사항입니다. 이 함수를 사용하면 서버 엔드포인트에서 예약할 MMIO 공간을 제안할 수 있습니다.

중요

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

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

요구 사항

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