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 和更新版本支援。 |
目標平臺 | 普遍 |
標頭 | ndis.h (包括 Ndis.h) |
連結庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_Miscellaneous_Function(ndis),NdisAllocateGenericObject(ndis) |