Macro NdisInitUnicodeString (ndis.h)

Articolo
02/07/2025

La funzione NdisInitUnicodeString inizializza una stringa Unicode con conteggiata.

Sintassi

void NdisInitUnicodeString(
   _us,
   s
);

Parametri

_us

Puntatore a un tipo NDIS_STRING allocato dal chiamante in cui NdisInitUnicodeString deve archiviare la stringa Unicode con conteggiata. Per Windows 2000 e versioni successive, NDIS definisce il tipo di NDIS_STRING come tipo UNICODE_STRING.

s

Puntatore a una stringa con terminazione Null con cui inizializzare la stringa con conteggiata.

Valore restituito

Nessuno

Osservazioni

Il DestinationString viene inizializzato in modo che punti al SourceString . Il Length e MaximumLength membri di NDIS_STRING per DestinationStr ing vengono inizializzati alla lunghezza della stringa in SourceString. Se SourceString è NULL, la lunghezza è zero.

I chiamanti di NdisInitUnicodeString devono essere eseguiti in IRQL <= DISPATCH_LEVEL se il buffer DestinationString viene allocato dalla memoria non di paging. In genere, i chiamanti vengono eseguiti in IRQL = PASSIVE_LEVEL durante l'inizializzazione del driver.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisInitUnicodeString (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisInitUnicodeString (NDIS 5.1)) in Windows XP.
piattaforma di destinazione	Universale
intestazione	ndis.h (include Ndis.h)
libreria	Ndis.lib
IRQL	Vedere la sezione Osservazioni
regole di conformità DDI	Irql_Miscellaneous_Function(ndis)