NdisInitializeString, fonction (ndis.h)
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.
void NdisInitializeString(
PNDIS_STRING Destination,
PUCHAR Source
);
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.
None
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 .
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) |