Funzione NdisAllocateGenericObject (ndis.h)
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) |