NDIS_PACKET

typedef struct _NDIS_PACKET {

    NDIS_PACKET_PRIVATE  Private;

    union {

        struct {

             UCHAR       MiniportReserved[2*sizeof(PVOID)];

             UCHAR       WrapperReserved[2*sizeof(PVOID)];

        };

        struct {

             UCHAR       MiniportReservedEx[3*sizeof(PVOID)];

             UCHAR       WrapperReservedEx[sizeof(PVOID)];

        };

        struct {

             UCHAR       MacReserved[4*sizeof(PVOID)];

        };

    };

    ULONG_PTR            Reserved[2];

    UCHAR                ProtocolReserved[1];

} NDIS_PACKET, *PNDIS_PACKET, **PPNDIS_PACKET;

NDIS_PACKET은 패킷 디스크립터를 정의한다. 체인화된(연결된) 버퍼 디스크립터 포인터들은 많은 NdisXXX, MiniportXXX, ProtocolXXX 함수에게 전달되어지는 포인터들이다.

멤버

Private
이것은 NDIS에 의해 exclusively 사용하도록 예약되었다. 드라이버들은 적당한 NdisXXX 함수나 NDIS 제공 매크로를 호출해야 한다. 이 영역의 내용들에 영향을 주려면은.

MiniportReserved
NIC 미니포트 드라이버와 NDIS 인터미디엇 드라이버들은 이러한 8바이트 영역을 사용할 수 있다. 그들 자신의 목적을 위하여, 각각의 그러한 드라이버들은 플레쉬 패킷 디스크립터들이 제공되어지는 한.

WrapperReserved
이것은 NDIS에 의해 exclusively하게 사용하기 위해 예약되었다.

MacReserved
이것은 리거시 풀 닉 드라이버에 의해 사용이 예약되었다.

ProtocolReserved
고 윗층 프로토콜 드라이버와 NDIS 인터미디엇 드라이버들은 이러한 가변 크기의 영역을 그들 자신을 위해 사용할 수 있다. 각각의 그러한 드라이버는 플레쉬 패킷 디스크립터에 제공되어진다.

주석

NDIS 드라이버들은 NdisAllocatePacket를 호출하여 모든 패킷 디스크립터 들을 할당한다. 그들은 이 패킷 디스크립터들을 사용하여 NdisMIndicateReceivePacket 으로 윗 계층 드라이버들이 받은 것들을 인지시키기 위해 사용되어진다. NDIS 드라이버들은 NdisAllocatePacket를 호출해야 한다. 그래서 모든 패킷 디스크립터들을 할당한다. 그들은 NdisSendPackets 혹은 NdisSend 를 사용해서 아랫 계층의 드라이버에게 보내기 위해 사용되어진다. 패킷 디스크립터들은 NdisTransferData에게 전달되어지는 것과 마찬가지로.

각 패킷 디스크립터들을 연결함으로써(chained to) 하나나 그 이상의 버퍼 디스크립터들을 네트워크 패킷 데이터를 포함하는 버퍼들에 맵핑한다. 패킷 데이터들은 받는 것이거나 보내는 것이다. NIC 드라이버들과 인터미디엇 드라이버들은 패킷 디스크립터들을 할당할 수 있다. receive indications을 위해 거의 16바이트의 ProtocolReserved 공간으로.

낮은 레벨 NDIS 드라이버들에 의해 할당된 버퍼들은 버퍼 디스크립터에 의해 맵되어야 한다. 버퍼 디스크립터들은 NdisAllocateBuffer함수로 buffer pool로부터 할당되어진다. 단지 높은 레벨의 윈도우즈 NT 프로토콜들은 MDL 셋업을 사용할 수 있다. 아직 높은 레벨 드라이버에서 NDIS_BUFFER 타입 디스크립터를 위한 대용으로 ....

NDIS 드라이버들은 전형적으로 그들의 직관적인(respective) XxxReserved 영역을 사용할 수 있다. 아웃스태팅한 전송(outstanding transfers)에 대한 패킷 당 상태를 유지하기 위해.... 예를 들어, 프로토콜은 lookahead 데이터를 포함하는 프로토콜 할당 버퍼에 대한 포인터를 저장한다. 그것의 ProtocolReceive 함수가 이미 카피 했던, 패킷 디스크립터의 ProtocolReserved 영역내에, 프로토콜은 NdisTransferData에 대한 호출로 할당한다.

하나의 드라이버는 MiniportReserved 영역을 사용한다. 하나의 드라이버는 ProtocolReserved 영역을 사용한다. 특정 패킷 디스크립터가 전송 연산에 사용되어지는 동안에(transfer operation). 결과적으로, NDIS Intermediate 드라이버들은 MiniportXxx와 ProtocolXxx 함수들 다 가지는, 이러한 영역을 사용할 수 없다. 그들 자신의 목적으로 들어오는 패킷 디스크립터들을 위해.

그 대신에 NDIS intermediate 드라이버들은 각 들어오는 패킷을 다시 패키지화 한다. 플레쉬 패킷 디스크립터내에 그것이 전송 요구로 전달하기 전에 아랫 계층 드라이버나 윗 계층 드라이버에.

이러한 전략은 NDIS intermediate 드라이버와 아랫 계층 드라이버 각각이 MiniportReserved 영역을 사용하기 위해 가지고, intermediate 드라이버와 윗 계층 프로토콜 각각이 ProtocolReserved 영역을 사용하기 위해 가지고, intermediate 드라이버는 편리하고 경제적인 방법으로 모든 현재 전송에 대해서 패킷 당 상태 정보를 유지하는 것을 확실히 한다. 이것은 또한 NDIS가 각 패킷 디스크립터의 Private 부분에 올바른 정보를 가지는 것을 확실히 한다.

드라이버들은 네트워크 전송에서 아웃오브 밴드 데이터를 공급하고 소비한다. 드라이버들은 멀티 패킷 리시브들과 보내는 것을 공급하기 위해 멤버 특정 NDIS_GET/SET_XXX 매크로를 사용해야 한다. 혹은 NDIS_OOB_DATA_FROM_PACKET 매크로를 사용해서 각 패킷 디스크립터와 관련된 NDIS_PACKET_OOB_DATA 블럭을 접근하기 위해 사용해야 한다.

프로토콜 드라이버는 NdisSendPackets or NdisSend를 패킷 디스크립터로 호출할 때, 그것이 패킷 디스크립터가 ProtocolSendComplete 함수로 리턴될 때까지 다음과 같은 소유를 구별한다:

  • 프로토콜 할당 디스크립터들

  • 패킷 디스크립터에 의해 연결된(chained to) 버퍼 디스크립터에 의해 맵된 모든 데이터 버퍼들.

  • 각각 프로토콜 하당 패킷 디스크립터와 관련된 모든 NDIS_PACKET_OOB_DATA 블럭들.

  • 관련 버퍼 디스크립터를 위해 NDIS_PACKET_OOB_DATA 블럭으로 지정된 out-of-band 데이터 버퍼.