FN_VMB_PACKET_INITIALIZE Rückruffunktion (vmbuskernelmodeclientlibapi.h)
[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]
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 des Puffers in Bytes.
Rückgabewert
VmbPacketInitialize gibt die folgenden status-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion wurde erfolgreich abgeschlossen. |
|
Der Wert von ByteCount ist ungültig. Er muss größer als die maximale Paketgröße plus die Größe eines Voidzeigers sein. |
Hinweise
Die Größe des Puffers muss mindestens die Größe sein, die mithilfe der Funktion VmbChannelSizeofPacket berechnet wird.
VmbPacketInitialize ist eine Alternative zur VmbPacketAllocate-Funktion . Verwenden Sie die aktuelle Funktion, wenn der Aufrufer den Arbeitsspeicher für das Paketobjekt bereitstellt.
Die anfängliche Vervollständigungsroutine 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1803 |
| Kopfzeile | vmbuskernelmodeclientlibapi.h |