NDIS_PER_PACKET_INFO_FROM_PACKET

PVOID

  NDIS_PER_PACKET_INFO_FROM_PACKET(

    IN/OUT PNDIS_PACKET  Packet,

    IN NDIS_PER_PACKET_INFO  InfoType

    );

NDIS_PER_PACKET_INFO_FROM_PACKET 함수는 패킷 디스크립터와 연관된 패킷당 정보의 특정 타입에 대한 포인터를 리턴한다.

매개변수

Packet
패킷 디스크립터를 가리킨다.

InfoType
이 매크로가 리턴하는 포인터에 대한 패킷당 정보의 특정 타입을 다음중 하나의 값으로 서술한다:

TcpIpChecksumPacketInfo
TCP/IP 트랜스포트에서 미니포트로 오프로딩 첵섬 작업에서 사용되는 첵섬 정보를 서술한다. 이 InfoType 값이 서술됐을 때 매크로는 NDIS_TCP_IP_CHECKSUM_PACKET_INFO 구조체에 대한 포인터를 리턴한다.

IpSecPacketInfo
TCP/IP 트랜스포트에서 미니포트로 오프로딩 IP 보안작업에서 사용되는 IP 보안정보를 서술한다. 이 InfoType 값이 서술됐을 때 매크로는 NDIS_IPSEC_PACKET_INFO 구조체에 대한 포인터를 리턴한다.

TcpLargeSendPacketInfo
TCP/IP 트랜스포트에서 미니포트로 큰 TCP 패킷의 오프로딩 세그먼테이션에서 사용되는 정보를 서술한다. 이 InfoType 값이 서술됬을 때 매크로는 ULONG 값을 포함하는 포인터를 리턴한다.

세그먼테이션을 위해서 큰 TCP 패킷을 미니포트로 전달하기 전에 TCP/IP 트랜스포트는 이 값을 현재 최대 전송유닛(MTU)인 최대 세그먼트 사이즈(MSS)로 쓴다. 더 작은 패킷으로 세그먼트되는 큰 TCP 패킷의 보내기를 완료하기 전에 미니포트는 이 값을 큰 TCP 패킷으로부터 세그먼트된 패킷안에서 보내진 사용자 데이타 바이트의 전체 수로 쓴다.

ClassificationHandlePacketInfo
이것은 예약되었다.

HeadIndexInfo
후에 문서화된다.

ScatterGatherListPacketInfo
DMA 연산에서 사용된 정보를 서술한다. 이 InfoType이 서술됐을 때 매크로는 SCATTER_GATHER_LIST 구조체에 대한 포인터를 리턴한다. 이 구조체는 패킷에 대한 DMA 데이타를 포함하는 버퍼의 맵된 논리 주소범위를 서술한다. NdisMInitializeScatterGatherDma 함수를 호출하므로써 DMA 연산에 대한 시스템 자원을 예약하는 미니포트는 NIC이 DMA 전송을 수행할 수 있게 하기 위해서 NIC에게 얻은 논리 주소범위를 제공한다.

Ieee8021pPriority
공유된 미디어 802 네트웍에서 패킷 우선권을 성립하기 위해서 사용된 802.1p 우선권 정보를 서술한다. 이 InfoType 값이 서술됐을 때 매크로는 IEEE8021PPRIORITY 타입을 리턴한다. ndis.h 헤더파일은 UINT로써 이 IEEE8021PPRIORITY를 정의한다. 이 UINT 안에 1로 설정된 비트는 802.1p 우선권 값을 서술한다. 패킷 디스크립터로부터 802.1p 우선권 값을 얻거나 패킷 디스크립터안으로 802.1p 우선권 값을 삽입하기 위해서 드라이버는 이 InfoType 값을 가지고 NDIS_PER_PACKET_INFO_FROM_PACKET 함수를 사용할 수 있다. 더 많은 정보는 네트웍 드라이버 디자인 가이드의 Part 2에 섹션 4.8.2를 봐라.

OriginalPacketInfo
전에 네트웍에서 받은 원래의 정보를 포함하고 NDIS 드라이버의 스택에 최하위 레벨 드라이버에 의해서 인디케이트된 패킷 디스크립터를 서술한다. 이 InfoType 값이 서술됐을 때 매크로는 NDIS_PACKET 구조체에 대한 포인터를 리턴한다. 드라이버는 이 원래 패킷의 정보를 얻거나 삽입하기 위해서 이 InfoType 값을 가지고 NDIS_PER_PACKET_INFO_FROM_PACKET 함수를 사용한다. 얻거나 삽입하는 이 방법을 사용하여 NDIS 드라이버의 층화된 스택에서 각각의 드라이버는 패킷이 각 층으로의 복사 요구없이 네트웍으로부터 얻은 패킷과 연관된 OOB 블럭으로 접근할 수 있다.

NdisInternalExtension1
후에 문서화된다.

NdisInternalExtension2
후에 문서화된다.

리턴값

NDIS_PER_PACKET_INFO_FROM_PACKET 함수는 InfoType에 의해서 서술된 패킷당 정보에 대한 포인터를 리턴한다. 혹은 패킷에 대한 그러한 패킷당 정보가 없다면 NULL을 리턴한다.

주석

패킷을 위해서 첵섬정보나 IP 보안정보와 같은 패킷당 정보의 한가지 타입만을 검사하고 설정할 필요가 있을 때 프로토콜이나 미니포트 드라이버는 이 매크로를 호출해야한다. 드라이버가 패킷에 대한 패킷당 정보의 하나의 타입 이상으로 접근할 필요가 있다면 드라이버는 the NDIS_PACKET_EXTENSION_FROM_PACKET 매크로를 호출해야한다.

이 매크로의 호출자는 어떤 IRQL에서도 실행할 수 있다.