Función NdisAllocateMemoryWithTagPriority (ndis.h)

Artículo
02/26/2024

Los controladores NDIS llaman a la función NdisAllocateMemoryWithTagPriority para asignar un grupo de memoria del grupo no paginado.

Sintaxis

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

Parámetros

[in] NdisHandle

Identificador NDIS que el autor de la llamada obtuvo durante la inicialización. Por ejemplo, un controlador de minipuerto puede usar el identificador NDIS que obtuvo del Función NdisMRegisterMiniportDriver o MiniportInitializeEx . Otros controladores NDIS pueden usar los identificadores de las siguientes funciones:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[in] Length

Tamaño que se va a asignar, en bytes.

[in] Tag

Una cadena, delimitada por comillas simples, con hasta cuatro caracteres, normalmente especificada en orden invertido. La etiqueta predeterminada proporcionada por NDIS para esta llamada es "maDN", pero el autor de la llamada puede invalidar este valor predeterminado proporcionando un valor explícito.

[in] Priority

Importancia de esta solicitud. Para obtener más información, vea ExAllocatePoolWithTagPriority.

Valor devuelto

NdisAllocateMemoryWithTagPriority devuelve un puntero a una dirección virtual base de la memoria asignada o NULL si la memoria no paginada suficiente no está disponible actualmente.

Comentarios

Para liberar memoria asignada con NdisAllocateMemoryWithTagPriority, llame a la función NdisFreeMemoryWithTagPriority o NdisFreeMemory .

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con NDIS 6.0 y versiones posteriores.
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_Miscellaneous_Function(ndis), NdisAllocateMemoryWithTagPriority(ndis), NdisAllocateMemoryWithTagPriority_Cleanup(ndis), NdisAllocateMemoryWithTagPriority_InitFail(ndis)