Macro NdisFreeString (ndis.h)

Artículo
02/29/2024

La función NdisFreeString libera el almacenamiento asignado por NdisInitializeString para una cadena almacenada en búfer.

Sintaxis

void NdisFreeString(
  [in]  String
);

Parámetros

[in] String

Valor de tipo NDIS_STRING que describe la cadena que se va a liberar. Para Windows 2000 y versiones posteriores, NDIS define el tipo de NDIS_STRING como un tipo de UNICODE_STRING .

Valor devuelto

None

Observaciones

Un controlador NDIS normalmente llama a la función NdisInitializeString durante la inicialización, por ejemplo, para configurar nombres pasados a las funciones de configuración de NdisXxx. Para cada llamada que realiza el controlador a NdisInitializeString, el controlador debe realizar una llamada correspondiente a NdisFreeString. Al liberar búferes de cadena asignados durante la inicialización, un controlador debe llamar a NdisFreeString antes de que la función de inicialización del controlador devuelva el control.

NdisFreeString solo se debe usar para liberar búferes asignados con NdisInitializeString.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con los controladores existentes en NDIS 6.0 y versiones posteriores, pero los nuevos controladores deben usar RtlFreeAnsiString o RtlFreeUnicodeString en su lugar.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	Irql_Miscellaneous_Function(ndis)