다음을 통해 공유


FN_VMB_PACKET_INITIALIZE 콜백 함수(vmbuskernelmodeclientlibapi.h)

[일부 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보와 관련하여 명시적이거나 묵시적인 보증을 하지 않습니다.]

VmbPacketInitialize 함수는 VMBus 패킷을 포함하도록 버퍼를 초기화합니다.

통사론

FN_VMB_PACKET_INITIALIZE FnVmbPacketInitialize;

NTSTATUS FnVmbPacketInitialize(
  VMBCHANNEL Channel,
  VMBPACKET VmbPacket,
  UINT32 ByteCount
)
{...}

매개 변수

Channel

채널에 대한 핸들입니다.

VmbPacket

VMBus 패킷을 저장하는 데 사용할 버퍼입니다.

ByteCount

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

반환 값

VmbPacketInitialize 다음 상태 코드를 반환합니다.

반환 코드 묘사
STATUS_SUCCESS
함수가 성공적으로 완료되었습니다.
STATUS_INVALID_PARAMETER_3
ByteCount 값이 잘못되었습니다. 최대 패킷 크기와 void 포인터의 크기보다 커야 합니다.

발언

버퍼의 크기는 VmbChannelSizeofPacket 함수를 사용하여 계산된 크기 이상이어야 합니다.

VmbPacketInitializeVmbPacketAllocate 함수의 대안입니다. 호출자가 패킷 개체에 대한 메모리를 제공하는 경우 현재 함수를 사용합니다.

패킷의 초기 완료 루틴이 잘못되었으며 패킷을 보내기 전에 설정해야 합니다.

중요하다

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

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

요구 사항

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

참고 항목

VmbChannelSizeofPacket

VmbPacketAllocate