Macro NdisFreeString (ndis.h)

Articolo
02/29/2024

La funzione NdisFreeString rilascia l'archiviazione allocata da NdisInitializeString per una stringa con buffer.

Sintassi

void NdisFreeString(
  [in]  String
);

Parametri

[in] String

Valore di tipo NDIS_STRING che descrive la stringa da liberare. Per Windows 2000 e versioni successive, NDIS definisce il tipo NDIS_STRING come tipo UNICODE_STRING .

Valore restituito

nessuno

Osservazioni

Un driver NDIS chiama in genere la funzione NdisInitializeString durante l'inizializzazione, ad esempio per configurare i nomi passati alle funzioni di configurazione NdisXxx. Per ogni chiamata eseguita dal driver a NdisInitializeString, il driver deve effettuare una chiamata corrispondente a NdisFreeString. Quando si rilasciano buffer stringa allocati durante l'inizializzazione, un driver deve chiamare NdisFreeString prima che la funzione di inizializzazione del driver restituisce il controllo.

NdisFreeString deve essere usato solo per liberare buffer allocati con NdisInitializeString.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver esistenti in NDIS 6.0 e versioni successive, ma i nuovi driver devono usare RtlFreeAnsiString o RtlFreeUnicodeString.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (includere Ndis.h)
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	Irql_Miscellaneous_Function(ndis)