Función NdisFreeMemory (ndis.h)

  • Artículo

La función NdisFreeMemory libera un bloque de memoria que se asignó anteriormente con la función NdisAllocateMemoryWithTagPriority .

Sintaxis

void NdisFreeMemory(
  [in] PVOID VirtualAddress,
  [in] UINT  Length,
  [in] UINT  MemoryFlags
);

Parámetros

[in] VirtualAddress

Puntero a la dirección virtual base de la memoria asignada. La función NdisAllocateMemoryWithTagPriority devolvió esta dirección.

[in] Length

Tamaño, en bytes, del bloque de memoria que se va a liberar. Si la memoria se asignó con NdisAllocateMemoryWithTagPriority o el parámetro MemoryFlags es cero, este parámetro se omite.

[in] MemoryFlags

Conjunto de marcas que especifican el tipo de memoria que se va a liberar. Este valor debe ser cero si la memoria se asignó con NdisAllocateMemoryWithTagPriority. Con NDIS 6.0 y versiones posteriores, NdisAllocateMemoryWithTagPriority siempre se usa para asignar memoria.

Valor devuelto

None

Observaciones

Dado que la memoria no almacenada en caché y la memoria contigua rara vez se liberan hasta que el controlador de miniporte asignado se descarga, un llamador de NdisFreeMemory normalmente se ejecuta en IRQL = PASSIVE_LEVEL para estos tipos de desasignaciones. En cualquier caso:

  • Al liberar memoria contigua, un llamador de NdisFreeMemory debe ejecutarse en IRQL = PASSIVE_LEVEL.
  • Al liberar memoria no almacenada en caché, un llamador de NdisFreeMemory debe ejecutarse en irQL < DISPATCH_LEVEL.
  • Al liberar memoria que no sea contigua ni no almacenada en caché, un autor de llamada de NdisFreeMemory debe ejecutarse en IRQL <= DISPATCH_LEVEL.

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisFreeMemory (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisFreeMemory (NDIS 5.1)) en Windows XP.
Plataforma de destino Universal
Encabezado ndis.h (incluya Ndis.h)
Library Ndis.lib
IRQL Consulte la sección Comentarios.
Reglas de cumplimiento de DDI Irql_Miscellaneous_Function(ndis),NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis), NdisQueryBindInstanceName(ndis)

Consulte también

MiniportHaltEx

NdisAllocateMemoryWithTagPriority