NDIS_PACKET_EXTENSION_FROM_PACKET

PNDIS_PACKET_EXTENSION

  NDIS_PACKET_EXTENSION_FROM_PACKET(

    IN PNDIS_PACKET  Packet

    );

NDIS_PACKET_EXTENSION_FROM_PACKET 함수는 패킷 디스크립터와 연관된 NDIS_PACKET_EXTENSION 구조체에 대한 포인터를 리턴한다.

매개변수

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

리턴값

NDIS_PACKET_EXTENSION_FROM_PACKET 함수는 패킷 디스크립터와 연관된 NDIS_PACKET_EXTENSION 구조체에 대한 포인터를 리턴한다. 혹은 패킷을 위한 패킷당 정보가 없다면 NULL을 리턴한다.

주석

NDIS_PACKET_EXTENSION 구조체는 패킷당 정보의 특정 타입을 가리키거나 포함하는 PVOID의 배열을 포함한다. NDIS_PACKET_EXTENSION 구조체의 포인터를 얻은 후에 드라이버는 패킷당 정보의 특정 타입으로 접근하기 위해서 적절한 배열 인덱스를 사용할 수 있다.

패킷과 연관된 패킷당 정보의 하나의 타입보다 많이 읽거나 쓸 필요가 있을 때 프로토콜 혹은 미니포트 드라이버는 이 매크로를 호출행야한다. 만약 드라이버가 패킷당 정보의 단지 하나의 타입으로 접근할 필요가 있다면 드라이버는 NDIS_PER_PACKET_INFO_FROM_PACKET 매크로를 호출해야한다.

NDIS_PACKET_EXTENSION_FROM_PACKET 함수에 의해서 리턴된 NDIS_PACKET_EXTENSION 함수의 포인터를 얻은 후에 드라이버는 패킷당 정보의 특정 티입으로 접근하기 위해서 다음 배열 인덱스중의 하나를 사용할 수 있다:

TcpIpChecksumPacketInfo
NDIS_TCP_IP_CHECKSUM_PACKET_INFO 구조체에 대한 포인터를 인덱스화해라.

IpSecPacketInfo
NDIS_IPSEC_PACKET_INFO 구조체에 대한 포인터를 인덱스화해라.

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

ClassificationHandlePacketInfo
예약.

HeadIndexInfo
후에 문서화된다.

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

Ieee8021pPriority
공유된 미디어 802 네트웍에서 패킷 우선권을 성립하기 위해서 사용된 802.1p 우선권 정보를 서술하는 UINT를 인덱스화해라. 이 UINT 안에 1로 설정된 비트는 802.1p 우선권 값을 서술한다.
더 많은 정보는 네트웍 드라이버 디자인 가이드의 Part2에 섹션 4.8을 봐라.

OriginalPacketInfo
NDIS_PACKET 구조체의 포인터를 인덱스화해라. 이 구조체는 네트웍에서 전에 리시브된 원래의 정보를 포함하고 NDIS 드라이버 스택에서 최하위 레벨 드라이버에 의해서 인디케이트된 패킷 디스크립터를 서술한다. 층화된 스택에서 각각의 드라이버는 패킷이 각각의 층으로 복사되는 요구없이 네트웍에서 리시브된 패킷과 연관된 OOB 데이타 블럭으로 접근할 수 있다.

NdisInternalExtension1
후에 문서화된다.

NdisInternalExtension2
후에 문서화된다.

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