FN_VMB_CHANNEL_INIT_SET_FRIENDLY_NAME Rückruffunktion (vmbuskernelmodeclientlibapi.h)

Artikel
03/01/2024

[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 Funktion VmbChannelInitSetFriendlyName legt den Anzeigenamen des KMCL-Kanals (Kernel Mode Client Library) fest. Der Anzeigename wird für das Debuggen und den Leistungsindikator instance Benennung verwendet.

Syntax

FN_VMB_CHANNEL_INIT_SET_FRIENDLY_NAME FnVmbChannelInitSetFriendlyName;

NTSTATUS FnVmbChannelInitSetFriendlyName(
  VMBCHANNEL Channel,
  PCUNICODE_STRING Name
)
{...}

Parameter

Channel

Ein Handle für den zu benennenden Kanal.

Name

Der neue Anzeigename des Kanals.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist, oder andernfalls einen entsprechenden NTSTATUS-Fehlercode.

Hinweise

Kanalnamen sollten beschreibend, aber relativ kurz und leicht zu verstehen sein, z. B. Network, SCSI, IDE oder SynthVideo.

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

Freigeben über