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)

另請參閱

NDIS_GENERIC_OBJECT

NdisFreeGenericObject