共用方式為


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)

另請參閱

NDIS_GENERIC_OBJECT

NdisFreeGenericObject