NDIS_GENERIC_OBJECT構造体 (ndis.h)

[アーティクル]
03/05/2024

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_GENERIC_OBJECT ) のNDIS_OBJECT_HEADER構造体。 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 プロトコル、中間、およびミニポートドライバーは、初期化中にハンドルを取得します。

NdisAllocateGenericObject で作成されたジェネリックオブジェクトを解放するには、NdisFreeGenericObject 関数を使用します。