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 资源。
NdisAllocateGenericObject 的 Size 参数指定要为调用方保留的内存量(以字节为单位)。 NdisAllocateGenericObject 在NDIS_OBJECT_STRUCTURE成员之后添加额外的内存。
大多数 NDIS 驱动程序不需要泛型对象即可获取句柄。 NDIS 协议、中间和微型端口驱动程序在初始化期间获取句柄。
使用 NdisFreeGenericObject 函数释放使用 NdisAllocateGenericObject 创建的泛型对象。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 NDIS 6.0 及更高版本中受支持。 |
标头 | ndis.h (包括 Ndis.h) |