Función NdisAllocateGenericObject (ndis.h)

Los componentes que no tienen un identificador NDIS usan la función NdisAllocateGenericObject para asignar un objeto NDIS genérico.

Sintaxis

PNDIS_GENERIC_OBJECT NdisAllocateGenericObject(
  [optional] PDRIVER_OBJECT DriverObject,
             ULONG          Tag,
             USHORT         Size
);

Parámetros

[optional] DriverObject

Objeto de controlador que se va a asociar al objeto genérico. Este parámetro puede ser null.

Tag

Etiqueta de memoria del kernel que NDIS debe usar para asignar memoria para el objeto genérico.

Size

Cantidad de memoria, en bytes, que se va a reservar para el autor de la llamada. Esto no incluye el tamaño de la estructura NDIS_GENERIC_OBJECT. Use el espacio de memoria adicional para sus propios fines. Para acceder a la memoria adicional, use sizeof(NDIS_GENERIC_OBJECT) para omitir la estructura de objetos genérica.

Valor devuelto

NdisAllocateGenericObject devuelve un puntero a la NDIS_GENERIC_OBJECT que asignó. Si NDIS no pudo crear el objeto, el valor devuelto es NULL.

Observaciones

NDIS usa un objeto genérico para administrar los recursos asignados por un componente que, de lo contrario, no tienen un identificador NDIS. Este componente usa el puntero de objeto genérico devuelto como identificador NDIS en algunas API de asignación de recursos NDIS que requieren un identificador NDIS.

Los controladores NDIS deben llamar a la función NdisFreeGenericObject para liberar un objeto genérico creado con NdisAllocateGenericObject.

Requisitos

Requisito	Valor
cliente mínimo admitido	Se admite en NDIS 6.0 y versiones posteriores.
de la plataforma de destino de	Universal
encabezado de	ndis.h (incluya Ndis.h)
biblioteca de	Ndis.lib
irQL	<= DISPATCH_LEVEL
reglas de cumplimiento de DDI	Irql_Miscellaneous_Function(ndis), NdisAllocateGenericObject(ndis)

Consulte también

NDIS_GENERIC_OBJECT

NdisFreeGenericObject