NdisAllocateGenericObject 函式 (ndis.h)
沒有 NDIS 句柄的元件會使用 NdisAllocateGenericObject 函式來配置泛型 NDIS 物件。
語法
PNDIS_GENERIC_OBJECT NdisAllocateGenericObject(
[optional] PDRIVER_OBJECT DriverObject,
ULONG Tag,
USHORT Size
);
參數
[optional] DriverObject
要與泛型物件建立關聯的驅動程序物件。 此參數可以是 Null。
Tag
NDIS 應該用來為泛型物件配置記憶體的核心記憶體卷標。
Size
要為呼叫端保留的記憶體數量，以位元組為單位。 這不包括 NDIS_GENERIC_OBJECT 結構的大小。 針對您自己的用途，請使用額外的記憶體空間。 若要存取額外的記憶體，請使用 sizeof (NDIS_GENERIC_OBJECT) 略過泛型物件結構。
傳回值
NdisAllocateGenericObject 會傳回其所配置之NDIS_GENERIC_OBJECT指標。 如果 NDIS 無法建立物件，則傳回值為 NULL。
備註
NDIS 會使用泛型物件來管理由沒有 NDIS 句柄之元件所配置的資源。 這類元件會在需要 NDIS 句柄的一些 NDIS 資源配置 API 中，使用傳回的泛型物件指標作為 NDIS 句柄。
NDIS 驅動程式必須呼叫 NdisFreeGenericObject 函式，以釋放以 NdisAllocateGenericObject 建立的泛型物件。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
| 目標平台 | Universal |
| 標頭 | ndis.h (包括 Ndis.h) |
| 程式庫 | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | Irql_Miscellaneous_Function (ndis) 、 NdisAllocateGenericObject (ndis) |