NDIS_SHARED_MEMORY_PARAMETERS 構造体 (ndis.h)

[アーティクル]
02/29/2024

NDIS_SHARED_MEMORY_PARAMETERS構造体は、共有メモリ割り当て要求の共有メモリパラメーターを指定します。

構文

typedef struct _NDIS_SHARED_MEMORY_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_RECEIVE_QUEUE_ID    QueueId;
  NDIS_HANDLE              SharedMemoryHandle;
  NODE_REQUIREMENT         PreferredNode;
  NDIS_SHARED_MEMORY_USAGE Usage;
  ULONG                    Length;
  PVOID                    VirtualAddress;
  ULONG                    SGListBufferLength;
  PSCATTER_GATHER_LIST     SGListBuffer;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NDIS_SHARED_MEMORY_PARAMETERS, *PNDIS_SHARED_MEMORY_PARAMETERS;

メンバー

Header

NDIS_SHARED_MEMORY_PARAMETERS構造体の型、リビジョン、およびサイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポートドライバーは、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_SHARED_MEMORY_PARAMETERS構造体のバージョンを指定するには、ドライバーは Header の Revision メンバーを次のいずれかの値に設定する必要があります。

NDIS_SHARED_MEMORY_PARAMETERS_REVISION_2

NDIS 6.30 の VPortId を 追加しました。

[サイズ] メンバーを [NDIS_SIZEOF_SHARED_MEMORY_PARAMETERS_REVISION_2] に設定します。

NDIS_SHARED_MEMORY_PARAMETERS_REVISION_1

NDIS 6.20 の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_SHARED_MEMORY_PARAMETERS_REVISION_1] に設定します。

Flags

次の値のビットごとの OR を含む UCHAR 値。

NDIS_SHARED_MEM_PARAMETERS_CONTIGOUS

共有メモリは、連続したメモリブロック内にあります。

QueueId

仮想マシンキュー (VMQ) または単一ルート I/O 仮想化 (SR-IOV) 受信キュー識別子を含むNDIS_RECEIVE_QUEUE_ID値。この識別子は、0 からミニポートアダプターがサポートするキューの数までの整数です。 NDIS_DEFAULT_RECEIVE_QUEUE_IDの値は、既定の受信キューを指定します。

メモWindows Server 2012以降、SR-IOV インターフェイスでは、既定の仮想ポートと既定以外の仮想ポート (VPorts) の両方で既定の受信キューのみがサポートされます。 SR-IOV インターフェイスをサポートするミニポートドライバーは、 QueueId メンバーをNDIS_DEFAULT_RECEIVE_QUEUE_IDに設定する必要があります。

SharedMemoryHandle

共有メモリのブロックを識別するNDIS_HANDLE値。 NDIS は、から戻る前にこのハンドルを提供します。 NdisAllocateSharedMemory 関数。

PreferredNode

メモリの割り当て中に使用する優先ノードを示すNODE_REQUIREMENT値。ドライバーに基本設定がない場合は、値を MM_ANY_NODE_OK に設定する必要があります。

Usage

共有メモリの目的を指定する NDIS_SHARED_MEMORY_USAGE 列挙値。

Length

共有メモリブロックの長さ (バイト単位) を含む ULONG 値。

VirtualAddress

共有メモリのベース仮想アドレスを含む PVOID 値。 NDIS は、 NdisAllocateSharedMemory 関数から返される前に、この値を提供します。

SGListBufferLength

散布図収集リストバッファーの長さ (バイト単位) を含む ULONG 値。

SGListBuffer

SCATTER_GATHER_LIST構造体へのポインター。

VPortId

共有メモリを割り当てる仮想ポート (VPort) 識別子を指定するNDIS_NIC_SWITCH_VPORT_ID値。この値は、ミニポートアダプターの物理関数 (PF) に接続されている既定以外の VPort の識別子である必要があります。

メモ VMQ インターフェイスをサポートするミニポートドライバーは、このメンバーを 0 に設定する必要があります。 SR-IOV インターフェイスをサポートするミニポートドライバーは、このメンバーを 0 (NDIS_DEFAULT_VPORT_ID) に設定しないでください。

注釈

NDIS_SHARED_MEMORY_PARAMETERS構造体は、受信キューの共有メモリ割り当て要求の共有メモリパラメーターを指定します。

NDIS ドライバーは、この構造体を NdisAllocateSharedMemory 関数に渡し、NDIS は、この構造体を NetAllocateSharedMemory 関数 (ALLOCATE_SHARED_MEMORY_HANDLERエントリポイント) に渡します。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.20 以降でサポートされています。
Header	ndis.h (Ndis.h を含む)

こちらもご覧ください

NDIS_OBJECT_HEADER

NDIS_SHARED_MEMORY_USAGE

NdisAllocateSharedMemory

NetAllocateSharedMemory

SCATTER_GATHER_LIST

次の方法で共有