NDIS_SHARED_MEMORY_PARAMETERS 구조체(ndis.h)
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 값은 기본 수신 큐를 지정합니다.
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의 식별자여야 합니다.
설명
NDIS_SHARED_MEMORY_PARAMETERS 구조는 수신 큐에 대한 공유 메모리 할당 요청에 대한 공유 메모리 매개 변수를 지정합니다.
NDIS 드라이버는 이 구조를 NdisAllocateSharedMemory 함수에 전달하고 NDIS는 이 구조를 NetAllocateSharedMemory 함수(ALLOCATE_SHARED_MEMORY_HANDLER 진입점)에 전달합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | NDIS 6.20 이상에서 지원됩니다. |
| 머리글 | ndis.h(Ndis.h 포함) |