Função NdisAllocateMemoryWithTagPriority (ndis.h)

Artigo
02/26/2024

Os drivers NDIS chamam a função NdisAllocateMemoryWithTagPriority para alocar um pool de memória do pool não paginado.

Sintaxe

PVOID NdisAllocateMemoryWithTagPriority(
  [in] NDIS_HANDLE      NdisHandle,
  [in] UINT             Length,
  [in] ULONG            Tag,
  [in] EX_POOL_PRIORITY Priority
);

Parâmetros

[in] NdisHandle

Um identificador NDIS que o chamador obteve durante a inicialização. 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] Length

O tamanho a ser alocado, em bytes.

[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.

[in] Priority

A importância dessa solicitação. Para obter mais informações, consulte ExAllocatePoolWithTagPriority.

Retornar valor

NdisAllocateMemoryWithTagPriority retorna um ponteiro para um endereço virtual base da memória alocada ou NULL se a memória nãopagada suficiente estiver indisponível no momento.

Comentários

Para liberar memória alocada com NdisAllocateMemoryWithTagPriority, chame a função NdisFreeMemoryWithTagPriority ou NdisFreeMemory .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino	Universal
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regras de conformidade da DDI	Irql_Miscellaneous_Function(ndis), NdisAllocateMemoryWithTagPriority(ndis), NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis)