Compartir a través de


Macro NdisFreeString (ndis.h)

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)

Consulte también

ANSI_STRING

DriverEntry de controladores de protocolo NDIS

MiniportInitializeEx

NdisOpenAdapterEx

NdisRegisterProtocolDriver

ProtocolBindAdapterEx

RtlInitString

RtlInitUnicodeString

RtlUnicodeStringToAnsiString

UNICODE_STRING