Função NdisFreeMemoryWithTagPriority (ndis.h)

A função NdisFreeMemoryWithTagPriority libera memória alocada com o Função NdisAllocateMemoryWithTagPriority .

Sintaxe

void NdisFreeMemoryWithTagPriority(
  [in] NDIS_HANDLE NdisHandle,
  [in] PVOID       VirtualAddress,
  [in] ULONG       Tag
);

Parâmetros

[in] NdisHandle

Um identificador de instância ou driver NDIS que foi obtido durante a inicialização do chamador. Esse deve ser o mesmo identificador que o driver passou para o Função NdisAllocateMemoryWithTagPriority . Por exemplo, um driver de miniporto pode usar o identificador NDIS obtido do Função NdisMRegisterMiniportDriver ou MiniportInitializeEx . Outros drivers NDIS podem usar os identificadores das seguintes funções:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[in] VirtualAddress

Um ponteiro para o endereço virtual base da memória alocada. Esse endereço foi retornado pelo Função NdisAllocateMemoryWithTagPriority .

[in] Tag

Uma cadeia de caracteres, delimitada por aspas simples, com até quatro caracteres, geralmente especificadas em ordem invertida. A marca padrão fornecida pelo NDIS para essa chamada é 'maDN', mas o chamador pode substituir esse padrão fornecendo um valor explícito.

Retornar valor

Nenhum

Comentários

Como a memória não armazenada em cache e a memória contígua raramente são liberadas até que o driver de miniporto alocador esteja sendo descarregado, um chamador de NdisFreeMemoryWithTagPriority geralmente está em execução em IRQL = PASSIVE_LEVEL para esses tipos de desalocações. De qualquer forma:

• Quando um chamador de NdisFreeMemoryWithTagPriority libera memória contígua, ele deve estar em execução em IRQL = PASSIVE_LEVEL.
• Quando um chamador de NdisFreeMemoryWithTagPriority libera memória não cache, ele deve estar em execução no IRQL < DISPATCH_LEVEL.
• Quando um chamador de NdisFreeMemoryWithTagPriority libera memória que não é contígua nem não armazenada em cache, ela deve estar em execução no IRQL <= DISPATCH_LEVEL.

Requisitos

Confira também

FilterAttach

MiniportInitializeEx

NdisFRegisterFilterDriver

NdisMRegisterMiniportDriver

NdisOpenAdapterEx

NdisRegisterProtocolDriver