Condividi tramite


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)

Vedi anche

ANSI_STRING

DriverEntry dei driver del protocollo NDIS

MiniportInitializeEx

NdisOpenAdapterEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

RtlInitString

RtlInitUnicodeString

RtlUnicodeStringToAnsiString

UNICODE_STRING