Macro NdisFreeString (ndis.h)
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) |