Compartir a través de

Función NdisAllocateGenericObject (ndis.h)

  • Artículo

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éricos.

Valor devuelto

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

Comentarios

NDIS usa un objeto genérico para administrar los recursos asignados por un componente que, de lo contrario, no tiene 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 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), NdisAllocateGenericObject(ndis)

Consulte también

NDIS_GENERIC_OBJECT

NdisFreeGenericObject