NdisMFreeSharedMemory

9/8/2008

Essa função libera memória que foi anteriormente alocada pelo NdisMAllocateSharedMemory pelo driver de um mestre barramento DMA NIC.

Syntax

VOID NdisMFreeSharedMemory(
  NDIS_HANDLE MiniportAdapterHandle,
  ULONG Length,
  BOOLEAN Cached,
  PVOID VirtualAddress,
  NDIS_PHYSICAL_ADDRESS PhysicalAddress
);

Parameters

• MiniportAdapterHandle
  [no] Especifica o identificador originalmente entrada para MiniportInitialize.

• Comprimento
  [no] Especifica o número de bytes alocados originalmente.

• Em cache
  [no] Especifica TRUE se o original alocação foi armazenáveis em cache.

• VirtualAddress
  [no] Especifica o endereço virtual de base retornado por NdisMAllocateSharedMemory.

• PhysicalAddress
  [no] Especifica o correspondente físico endereço retornado por NdisMAllocateSharedMemory.

Return Value

Nenhum.

Remarks

Se o driver NIC de um mestre barramento acesso direto à memória (DMA) dispositivo já tiver feito um bem-sucedido chamar para NdisMAllocateSharedMemory, ele irá chamar NdisMFreeSharedMemory Se qualquer um do seguinte ocorre:

• Seu MiniportInitialize função não consegue inicializar o NIC, portanto, essa função deve versão todos existente alega em hardware recursos para que NIC antes de que retornará controle.
• O NIC para o qual a miniporta alocado a memória está sendo removido.
• O driver está sendo descarregado porque o sistema está sendo encerrado ou porque o usuário reconfigurado componentes de rede usados na máquina.

Uma miniporta não é possível chamar NdisMFreeSharedMemory a livre um Subrange dentro uma alocado intervalo memória compartilhada. Os parâmetros passados para NdisMFreeSharedMemory deve corresponder exatamente aqueles que foram passados para NdisMAllocateSharedMemory.

NdisMFreeSharedMemory não pode ser chamado de um MiniportShutdownfunção.

Requirements

Header	ndis.h
Library	ndis.dll
Windows Embedded CE	Windows CE .NET 4.0 and later

See Also

Reference

MiniportInitialize
MiniportShutdown
NdisMAllocateSharedMemory