Macro NdisInitUnicodeString (ndis.h)

Article
02/07/2025

La fonction NdisInitUnicodeString initialise une chaîne Unicode comptée.

Syntaxe

void NdisInitUnicodeString(
   _us,
   s
);

Paramètres

_us

Pointeur vers un type NDIS_STRING alloué par l’appelant dans lequel NdisInitUnicodeString doit stocker la chaîne Unicode comptée. Pour Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING en tant que type UNICODE_STRING.

s

Pointeur vers une chaîne terminée par null avec laquelle initialiser la chaîne comptée.

Valeur de retour

Aucun

Remarques

Le destinationString est initialisé pour pointer vers le SourceString . Les membres length et MaximumLength de NDIS_STRING pour le DestinationString sont initialisés à la longueur de la chaîne à SourceString. Si SourceString est NULL, la longueur est égale à zéro.

Les appelants de NdisInitUnicodeString doivent s’exécuter à l'<IRQL = DISPATCH_LEVEL si la mémoire tampon DestinationString est allouée à partir de la mémoire non paginée. En règle générale, les appelants s’exécutent à IRQL = PASSIVE_LEVEL pendant l’initialisation du pilote.

Exigences

Exigence	Valeur
client minimum pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisInitUnicodeString (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisInitUnicodeString (NDIS 5.1)) dans Windows XP.
plateforme cible	Universel
d’en-tête	ndis.h (include Ndis.h)
bibliothèque	Ndis.lib
IRQL	Voir la section Remarques
règles de conformité DDI	Irql_Miscellaneous_Function(ndis)