NDIS_GENERIC_OBJECT 结构 (ndis.h)

NDIS_GENERIC_OBJECT 结构定义了一个泛型对象,软件组件可以使用该对象来获取 NDIS 句柄。

语法

typedef struct _NDIS_GENERIC_OBJECT {
  NDIS_OBJECT_HEADER Header;
  PVOID              Caller;
  PVOID              CallersCaller;
  PDRIVER_OBJECT     DriverObject;
} NDIS_GENERIC_OBJECT, *PNDIS_GENERIC_OBJECT;

成员

Header

型对象结构的NDIS_OBJECT_HEADER结构 (NDIS_GENERIC_OBJECT) 。 NDIS 将 Header 指定的结构的 Type 成员设置为 NDIS_OBJECT_TYPE_GENERIC_OBJECT,将 Revision 成员设置为NDIS_GENERIC_OBJECT_REVISION_1,将 Size 成员设置为 sizeof (NDIS_GENERIC_OBJECT) 。

Caller

保留给 NDIS。

CallersCaller

保留给 NDIS。

DriverObject

与泛型对象关联的驱动程序对象。 如果没有驱动程序对象,则此成员为 NULL。 这是在 的 DriverObject 参数处传递的值 NdisAllocateGenericObject 函数。

注解

尚没有 NDIS 句柄的软件组件调用 NdisAllocateGenericObject 来创建泛型对象。 此类组件使用从 NdisAllocateGenericObject 获取的句柄来分配 NDIS 资源。

NdisAllocateGenericObjectSize 参数指定要为调用方保留的内存量(以字节为单位)。 NdisAllocateGenericObject 在NDIS_OBJECT_STRUCTURE成员之后添加额外的内存。

大多数 NDIS 驱动程序不需要泛型对象即可获取句柄。 NDIS 协议、中间和微型端口驱动程序在初始化期间获取句柄。

使用 NdisFreeGenericObject 函数释放使用 NdisAllocateGenericObject 创建的泛型对象。

要求

要求
最低受支持的客户端 在 NDIS 6.0 及更高版本中受支持。
标头 ndis.h (包括 Ndis.h)

另请参阅

NDIS_OBJECT_HEADER

NdisAllocateGenericObject

NdisFreeGenericObject