Macro NdisFreeString (ndis.h)
La función NdisFreeStr ing 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
Ninguno
Observaciones
Normalmente, un controlador NDIS llama a la función NdisInitializeString durante la inicialización; por ejemplo, para configurar nombres pasados a las funciones de NdisXxxConfiguration. Para cada llamada que realiza el controlador para 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 debe usarse para liberar búferes asignados con NdisInitializeString.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Se admite para los controladores existentes en NDIS 6.0 y versiones posteriores, pero los nuevos controladores deben usar RtlFreeAnsiString o RtlFreeUnicodeString en su lugar. |
| de la plataforma de destino de | Escritorio |
| encabezado de | ndis.h (incluya Ndis.h) |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | Irql_Miscellaneous_Function(ndis) |