FN_VMB_PACKET_INITIALIZE Rückruffunktion (vmbuskernelmodeclientlibapi.h)
[Einige Informationen beziehen sich auf vorab veröffentlichte Produkte, die vor der kommerziellen Veröffentlichung erheblich geändert werden können. Microsoft übernimmt keine Gewährleistungen, ausdrücklich oder konkludent in Bezug auf die hier bereitgestellten Informationen.]
Die VmbPacketInitialize Funktion initialisiert einen Puffer, der ein VMBus-Paket enthält.
Syntax
FN_VMB_PACKET_INITIALIZE FnVmbPacketInitialize;
NTSTATUS FnVmbPacketInitialize(
VMBCHANNEL Channel,
VMBPACKET VmbPacket,
UINT32 ByteCount
)
{...}
Parameter
Channel
Ein Handle für einen Kanal.
VmbPacket
Der Puffer, der zum Speichern des VMBus-Pakets verwendet werden soll.
ByteCount
Die Größe Puffer-in Byte.
Rückgabewert
VmbPacketInitialize gibt die folgenden Statuscodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion wurde erfolgreich abgeschlossen. |
|
Der Wert ByteCount- ist ungültig. Er muss größer als die maximale Paketgröße und die Größe eines leeren Zeigers sein. |
Bemerkungen
Die Größe des Puffers muss mindestens die größe sein, die mithilfe der VmbChannelSizeofPacket--Funktion berechnet wird.
VmbPacketInitialize ist eine Alternative zur funktion VmbPacketAllocate. Verwenden Sie die aktuelle Funktion, wenn der Aufrufer den Speicher für das Paketobjekt bereitstellt.
Die anfängliche Abschlussroutine des Pakets ist ungültig und muss vor dem Senden des Pakets festgelegt werden.
Wichtig
Diese Funktion wird über die KMCL-Schnittstelle (VMBus Kernel Mode Client Library) aufgerufen, die vom Vmbkmcl.sys Bustreiber bereitgestellt wird. Dies ist eine Clientfunktion, auf die über die KMCL_CLIENT_INTERFACE_V1 Struktur zugegriffen wird.
Weitere Informationen finden Sie im Abschnitt "Hinweise" des KMCL_CLIENT_INTERFACE_V1.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1803 |
| Header- | vmbuskernelmodeclientlibapi.h |