NDIS_SHARED_MEMORY_PARAMETERS 구조체(ndis.h)

아티클
08/07/2023

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 가 추가되었습니다.

Size 멤버를 NDIS_SIZEOF_SHARED_MEMORY_PARAMETERS_REVISION_2 설정합니다.

NDIS_SHARED_MEMORY_PARAMETERS_REVISION_1

NDIS 6.20의 원래 버전입니다.

Size 멤버를 NDIS_SIZEOF_SHARED_MEMORY_PARAMETERS_REVISION_1 설정합니다.

Flags

다음 값의 비트 OR을 포함하는 UCHAR 값입니다.

NDIS_SHARED_MEM_PARAMETERS_CONTIGOUS

공유 메모리는 연속된 메모리 블록에 있습니다.

QueueId

VMQ(가상 머신 큐) 또는 SR-IOV(단일 루트 I/O 가상화)가 포함된 NDIS_RECEIVE_QUEUE_ID 값은 큐 식별자를 수신합니다. 이 식별자는 미니포트 어댑터가 지원하는 큐 수와 0 사이의 정수입니다. NDIS_DEFAULT_RECEIVE_QUEUE_ID 값은 기본 수신 큐를 지정합니다.

참고 Windows Server 2012 SR-IOV 인터페이스는 기본 및 기본이 아닌 VPort(가상 포트)에서 기본 수신 큐만 지원합니다. 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 이상에서 지원됩니다.
머리글	ndis.h(Ndis.h 포함)

추가 정보

NDIS_OBJECT_HEADER

NDIS_SHARED_MEMORY_USAGE

NdisAllocateSharedMemory

NetAllocateSharedMemory

SCATTER_GATHER_LIST