NDIS_PACKET_EXTENSION
typedef struct _NDIS_PACKET_EXTENSION
{
PVOID NdisPacketInfo[MaxPerPacketInfo];
} NDIS_PACKET_EXTENSION, *PNDIS_PACKET_EXTENSION;
|
NDIS_PACKET_EXTENSION은 각각은 패킷 디스크립터와 관련된 패킷당(per-packet,
out-of-band) 정보를 포함하거나 혹은 가리키는 배열 포인터들을 포함한다.
멤버
- NdisPacketInfo[MaxPerPacketInfo]
- 각각이 특정 태스크에 지정된 패킷 당 정보를 포함하거나 혹은 가리키는 배열
포인터들이다. 배열의 인덱스 값들은 다음과 같이 정의되어 있다:
- TcpIpCheckSumPacketInfo
- NDIS_TCP_IP_CHECKSUM_PACKET_INFO 구조체를 포함하거나 혹은 가리키는
포인터를 인덱스한다. 이 구조체는 NIC에 대해 TCP/IP 전송으로부터 오프로드된
체크섬 연산들을 위한 패킷 당 정보를 지정한다.
- IpSecPacketInfo
- NDIS_IPSEC_PACKET_INFO 구조체를 가리키는 포인터를 인덱스한다. 이 구조체는
TCP/IP 전송으로부터 NIC으로 오프로드된 IP Security 연산들을 위해 패킷당
정보를 지정한다.
- TcpLargeSendPacketInfo
- ULONG 값을 포함하는 포인터를 인덱스한다. 세그먼트를 위해 NIC에게 큰 TCP
패킷을 전달하기 전에, TCP/IP 전송은(transport) 이 값을 현재 최대 전송 단위
(Maximum Transmission Unit : MTU)과 상당한 최대 세그먼트 크기(MSS :
Maximum segment size)를 설정한다. MTU는 패킷에 포함되어질 수 있는
사용자 데이터 바이트들의 최대 수이다. 미니포트는 MSS 값을 사용하여
큰 TCP 패킷을 더 짧은 패킷들로 세그먼트화한다. 보내기 연산을 완성하기 전에
(예를 들어, NdisMSendComplete 혹은 NdisMCoSendComplete로), 미니포트는
큰 TCP 패킷으로부터 유도된 모든 패킷들내에 보내어진 사용자 데이터 바이트들의
총 수로 ULONG 값을 쓴다.
- ClassificationHandlePacketInfo
- 이것은 예약되었다.
- HeaderIndexInfo
- 나중에 문서화될 것이다.
- ScatterGatherListPacketInfo
- 패킷을 위해 DMA 데이터를 포함하는 버퍼들의 맵된 논리 주소 범위들을 지정하는
SCATTER_GATHER_LIST 구조체에 대한 포인터를 인덱스한다.
NdisMIntializeScatterGatherDma를 호출함으로써 DMA 연산들을 위한 시스템 자원들을
예약하는 미니포트는 NIC이 DMA 전송을 행할 수 있기 위해 NIC에게 얻은 논리 주소
범위들을 제공한다.
- Ieee8021pPriority
- 공유된 미디어 802 네트워크들에서 패킷 우선권을 설립하기 위해 사용되어지는
802.1p priority 정보를 지정하는 UINT를 인덱스한다.
이 UINT에 하나로 설정된 비트들은 802.1p 우선권 값을 지정한다.
더 많은 정보를 위해, Network Drivers Design Guide의 part 2내에 Section 4.8를
봐라.
- OriginalPacketInfo
- NDIS_PACKET 구조체에 대한 포인터를 인덱스한다. 이 구조체는 전에 네트워크을
걸쳐 수신되고 NDIS 드라이버들의 스택내에 가장 낮은 레벨 드라이버에 의해
위로 인디케이트된 원래 정보를 포함하는 패킷 디스크립터를 지정한다.
계층화된 스택내에서 각 드라이버는 패킷이 각 층에 복사되어지는 것이 요구
되어지는 것이 것이 없이 네트워크으로부터 수신된 패킷과 관련된 out-of-band
(OOB) 데이터 블럭을 처리할 수 있다.
- NdisInternalExtension1
- 나중에 문서화되어질 것이다.
- NdisInternalExtension2
- 나중에 문서화되어질 것이다.
주석
NdisAllocatePacket으로 할당된 모든 패킷 디스크립터는 관련된 NDIS_PACKET_EXTENSION를
가진다.
이 구조체는 각각은 패킷 디스크립터과 관련된 특정 타입의 패킷 당 정보를 포함하거나
가리키는 포인터들 배열(PVOID)을 포함한다. 패킷당 정보는 NDIS_PACKET_OOB_DATA 블럭에
의해 지정된 것에 추가적으로 out-of-band(OOB) 데이터이다.
NDIS_PACKET_EXTENSION 구조체는 패킷 디스크립터와 관련된 OOB 데이터를 확장한다.
패킷당 정보를 접근하기 위해, 드라이버들은 다음과 같은 매크로들의 하나를 사용한다.
- NDIS_PACKET_EXTENSION 구조체에 대한 포인터를 리턴하는 NDIS_PACKET_EXTENSION_PACKET
드라이버가 만약 패킷 디스크립터와 관련된 패킷당 정보의 하나 이사의 타입들에
접근할 필요가 있다면은 이 매크로를 호출해야 한다. NDIS_PACKET_EXTENSION 구조체에
대한 포인터를 얻은 후에, 드라이버는 패킷당 정보의 특정 타입에 대한 포인터를 얻기 위한
적당한 배열 인덱스를 사용할 수 있다.
- 특정 타입의 패킷당 정보에 대한 포인터를 리턴하는 NDIS_PER_PACKET_INFO_FROM_PACKET.
드라이버는 단지 하나의 타입의 패킷당 정보를 접근할 필요가 있을 때 이 매크로를
호출해야 한다.
|