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 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:
[in] VirtualAddress
Um ponteiro para o endereço virtual base da memória alocada. Este endereço foi retornado pelo função NdisAllocateMemoryWithTagPriority.
[in] Tag
Uma cadeia de caracteres, delimitada por aspas simples, com até quatro caracteres, geralmente especificada 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.
Valor de retorno
Nenhum
Observações
Como memória não armazenada em cache e memória contígua raramente são liberadas até que o driver de miniporto alocador esteja descarregando, um chamador de NdisFreeMemoryWithTagPriority geralmente está em execução em IRQL = PASSIVE_LEVEL para esses tipos de desalocações. Em qualquer caso:
- Quando um chamador do NdisFreeMemoryWithTagPriority libera memória contígua, ele deve estar em execução em IRQL = PASSIVE_LEVEL.
- Quando um chamador do NdisFreeMemoryWithTagPriority libera memória não em cache, ele deve estar em execução no < DISPATCH_LEVEL IRQL.
- Quando um chamador do 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
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte no NDIS 6.20 e posterior. |
| da Plataforma de Destino | Universal |
| cabeçalho | ndis.h (inclua Ndis.h) |
| biblioteca | Ndis.lib |
| IRQL | Consulte a seção Comentários. |
| regras de conformidade de DDI | NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis) |