Macro NdisInitUnicodeString (ndis.h)

Article
02/29/2024

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

Syntaxe

void NdisInitUnicodeString(
   _us,
   s
);

Paramètres

_us

Pointeur vers un type de 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

None

Remarques

DestinationString est initialisé pour pointer vers sourceString . Les membres Length et MaximumLength de NDIS_STRING pour destinationString sont initialisés à la longueur de la chaîne dans SourceString. Si SourceString a la valeur NULL, la longueur est égale à zéro.

Les appelants de NdisInitUnicodeString doivent s’exécuter sur 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 sur IRQL = PASSIVE_LEVEL pendant l’initialisation du pilote.

Configuration requise

Condition requise	Valeur
Client minimal 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	Universal
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	Voir la section Notes
Règles de conformité DDI	Irql_Miscellaneous_Function(ndis)