Funzione NdisAllocateGenericObject (ndis.h)

  • Articolo

I componenti che non dispongono di un handle NDIS usano la funzione NdisAllocateGenericObject per allocare un oggetto NDIS generico.

Sintassi

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

Parametri

[optional] DriverObject

Oggetto driver da associare all'oggetto generico. Questo parametro può essere NULL.

Tag

Tag di memoria del kernel che NDIS deve usare per allocare memoria per l'oggetto generico.

Size

Quantità di memoria, in byte, da riservare per il chiamante. Ciò non include le dimensioni della struttura NDIS_GENERIC_OBJECT . Usare lo spazio di memoria aggiuntivo per scopi personalizzati. Per accedere alla memoria aggiuntiva, usare sizeof(NDIS_GENERIC_OBJECT) per ignorare la struttura di oggetti generici.

Valore restituito

NdisAllocateGenericObject restituisce un puntatore al NDIS_GENERIC_OBJECT allocato. Se NDIS non è riuscito a creare l'oggetto, il valore restituito è NULL.

Commenti

NDIS usa un oggetto generico per gestire le risorse allocate da un componente che altrimenti non dispone di un handle NDIS. Tale componente usa il puntatore a oggetti generico restituito come handle NDIS in alcune API di allocazione delle risorse NDIS che richiedono un handle NDIS.

I driver NDIS devono chiamare la funzione NdisFreeGenericObject per liberare un oggetto generico creato con NdisAllocateGenericObject.

Requisiti

Requisito Valore
Client minimo supportato Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione Universale
Intestazione ndis.h (includere Ndis.h)
Libreria Ndis.lib
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI Irql_Miscellaneous_Function(ndis), NdisAllocateGenericObject(ndis)

Vedi anche

NDIS_GENERIC_OBJECT

NdisFreeGenericObject