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 指定要NDIS_OBJECT_TYPE_GENERIC_OBJECT的 Type 成員、要NDIS_GENERIC_OBJECT_REVISION_1的 Revision 成員,並將 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) |