Funzione NdisInitializeString (ndis.h)
La funzione NdisInitializeString alloca l'archiviazione per e inizializza una stringa conteggiata nel set di caratteri predefinito del sistema.
Sintassi
void NdisInitializeString(
PNDIS_STRING Destination,
PUCHAR Source
);
Parametri
Destination
Puntatore a un NDIS_STRING con un buffer NULL . In caso di ritorno da questa funzione, l'NDIS_STRING contiene una stringa inizializzata e conteggiata. Per Windows 2000 e versioni successive, NDIS definisce il tipo NDIS_STRING come tipo UNICODE_STRING .
Source
Puntatore a una stringa con terminazione null con cui inizializzare la stringa conteggiata. SourceString non deve essere NULL.
Valore restituito
nessuno
Osservazioni
NdisInitializeString imposta i membri Length e MaximumLength di NDIS_STRING per la stringa di destinazione e termina la stringa di destinazione con zero. Per Windows 2000 e versioni successive, NdisInitializeString converte la stringa di origine fornita in caratteri Unicode.
SourceString non deve essere NULL.
Il buffer allocato da NdisInitializeString deve essere rilasciato con la funzione NdisFreeString .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver esistenti in NDIS 6.0 e versioni successive, ma i nuovi driver devono usare RtlInitUnicodeString o RTL_CONSTANT_STRING o DECLARE_CONST_UNICODE_STRING (vedere ntdef.h). |
| Piattaforma di destinazione | Universale |
| Intestazione | ndis.h (includere Ndis.h) |
| Libreria | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | Irql_Miscellaneous_Function(ndis) |