NdisInitializeString-Funktion (ndis.h)

Artikel
02/26/2024

Die NdisInitializeString-Funktion weist Speicher für und initialisiert eine gezählte Zeichenfolge im Systemstandardzeichensatz.

Syntax

void NdisInitializeString(
  PNDIS_STRING Destination,
  PUCHAR       Source
);

Parameter

Destination

Ein Zeiger auf eine NDIS_STRING mit einem NULL-Puffer . Bei der Rückgabe von dieser Funktion enthält die NDIS_STRING eine initialisierte, gezählte Zeichenfolge. Für Windows 2000 und höher definiert NDIS den NDIS_STRING-Typ als UNICODE_STRING Typ.

Source

Ein Zeiger auf eine NULL-Zeichenfolge, mit der die gezählte Zeichenfolge initialisiert werden soll. SourceString darf nicht NULL sein.

Rückgabewert

Keine

Bemerkungen

NdisInitializeString legt die Length - und MaximumLength-Member von NDIS_STRING für die Zielzeichenfolge fest und beendet die Zielzeichenfolge mit null. Für Windows 2000- und höhere Treiber konvertiert NdisInitializeString die angegebene Quellzeichenfolge in Unicode-Zeichen.

SourceString darf nicht NULL sein.

Der von NdisInitializeString zugewiesene Puffer sollte mit der NdisFreeString-Funktion freigegeben werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Wird für vorhandene Treiber in NDIS 6.0 und höher unterstützt, aber neue Treiber sollten stattdessen RtlInitUnicodeString oder RTL_CONSTANT_STRING oder DECLARE_CONST_UNICODE_STRING (siehe ntdef.h) verwenden.
Zielplattform	Universell
Header	ndis.h (einschließlich Ndis.h)
Bibliothek	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Miscellaneous_Function(ndis)