NdisInitUnicodeString-Makro (ndis.h)

Artikel
02/07/2025

Die NdisInitUnicodeString Funktion initialisiert eine gezählte Unicode-Zeichenfolge.

Syntax

void NdisInitUnicodeString(
   _us,
   s
);

Parameter

_us

Ein Zeiger auf einen vom Aufrufer zugewiesenen NDIS_STRING Typ, in dem NdisInitUnicodeString die gezählte Unicode-Zeichenfolge speichern soll. Für Windows 2000 und höher definiert NDIS den NDIS_STRING Typ als UNICODE_STRING Typ.

s

Ein Zeiger auf eine mit Null beendete Zeichenfolge, mit der die gezählte Zeichenfolge initialisiert werden soll.

Rückgabewert

Nichts

Bemerkungen

Die DestinationString- wird initialisiert, um auf die SourceString- zu verweisen. Die elemente Length und MaximumLength member of NDIS_STRING for the DestinationString are initialized to the length of the string at SourceString. Wenn SourceString-NULL-ist, ist die Länge Null.

Aufrufer von NdisInitUnicodeString- müssen bei IRQL-<= DISPATCH_LEVEL ausgeführt werden, wenn der DestinationString- Puffer aus nicht ausgelagertem Speicher zugeordnet wird. In der Regel werden Aufrufer bei IRQL = PASSIVE_LEVEL während der Treiberinitialisierung ausgeführt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisInitUnicodeString (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisInitUnicodeString (NDIS 5.1)) in Windows XP.
Zielplattform-	Universal
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	Siehe Abschnitt "Hinweise"
DDI-Complianceregeln	Irql_Miscellaneous_Function(ndis)