NdisInitializeString, fonction (ndis.h)

Article
02/29/2024

La fonction NdisInitializeString alloue le stockage pour et initialise une chaîne comptée dans le jeu de caractères par défaut système.

Syntaxe

void NdisInitializeString(
  PNDIS_STRING Destination,
  PUCHAR       Source
);

Paramètres

Destination

Pointeur vers un NDIS_STRING avec une mémoire tampon NULL . Au retour de cette fonction, le NDIS_STRING contient une chaîne initialisée et comptée. Pour Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING comme un type UNICODE_STRING .

Source

Pointeur vers une chaîne terminée par null avec laquelle initialiser la chaîne comptée. SourceString ne doit pas avoir la valeur NULL.

Valeur de retour

None

Remarques

NdisInitializeString définit les membres Length et MaximumLength de NDIS_STRING pour la chaîne de destination et termine la chaîne de destination par zéro. Pour les pilotes Windows 2000 et versions ultérieures, NdisInitializeString convertit la chaîne source fournie en caractères Unicode.

SourceString ne doit pas avoir la valeur NULL.

La mémoire tampon allouée par NdisInitializeString doit être libérée avec la fonction NdisFreeString .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes existants dans NDIS 6.0 et versions ultérieures, mais les nouveaux pilotes doivent utiliser RtlInitUnicodeString ou RTL_CONSTANT_STRING ou DECLARE_CONST_UNICODE_STRING (voir ntdef.h) à la place.
Plateforme cible	Universal
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	Irql_Miscellaneous_Function(ndis)