NDIS_WAN_PACKET

typedef struct _NDIS_WAN_PACKET {

    LIST_ENTRY          WanPacketQueue;

    PUCHAR              CurrentBuffer;

    ULONG               CurrentLength;

    PUCHAR              StartBuffer;

    PUCHAR              EndBuffer;

    PVOID               ProtocolReserved1;

    PVOID               ProtocolReserved2;

    PVOID               ProtocolReserved3;

    PVOID               ProtocolReserved4;

    PVOID               MacReserved1;

    PVOID               MacReserved2;

    PVOID               MacReserved3;

    PVOID               MacReserved4;

} NDIS_WAN_PACKET, *PNDIS_WAN_PACKET;

NDIS_WAN_PACKET 구조체는 WAN NIC 드라이버들의 MiniportWanSend 함수들에 전달되는 패킷을 정의한다.

멤버

WanPacketQueue
미니포트가 이 패킷을 처리하는 동안 MiniportWanSend 함수에 의해 사용된 보내기 패킷 큐의 헤드를 지정한다.

CurrentBuffer
전송되어질 네트워크 패킷이 시작하는 주어진 버퍼내에 베이스 가상 주소를 지정한다.

CurrentLength
네트워크 패킷 데이터의 바이트 수를 지정한다.

StartBuffer
패딩을 포함해서, 주어진 버퍼를 위한 베이스 가상 주소를 지정한다.

EndBuffer
패딩을 포함해서, 주어진 버퍼의 끝을 위한 가상 주소를 지정한다.

ProtocolReserved1
프로토콜들에 의한 사용을 위해 예약된 멤버들을 지정한다.

ProtocolReserved2
프로토콜들에 의한 사용을 위해 예약된 멤버들을 지정한다.

ProtocolReserved3
프로토콜들에 의한 사용을 위해 예약된 멤버들을 지정한다.

ProtocolReserved4
프로토콜들에 의한 사용을 위해 예약된 멤버들을 지정한다.

MacReserved1
미니포트가 자신의 목적들을 위해 사용할 수 있는 멤버들을 지정한다.

MacReserved2
미니포트가 자신의 목적들을 위해 사용할 수 있는 멤버들을 지정한다.

MacReserved3
미니포트가 자신의 목적들을 위해 사용할 수 있는 멤버들을 지정한다.

MacReserved4
미니포트가 자신의 목적들을 위해 사용할 수 있는 멤버들을 지정한다.

주석

프로토콜이 아래 WAN NIC 드라이버를 위한 NDIS_PACKET 타입 전송 요구로 NdisSend 함수를 호출할 때, NDISWAN은 주어진 패킷을 아래 드라이버의 MiniportWanSend 함수를 호출하기 전에 이러한 구조체로서 포맷화된 패킷으로 변형한다.

StartBuffer와 EndBuffer 포인터들은 분산 가상 범위를 지정한다. CurrentBuffer와 CurrentLength는 StatrtBuffer와 EndBuffer에 의해 지정된 범위의 적당한 서브범위를 지정한다. 결과적으로, 다음 공식들의 하나가 MiniportWanSend에 대한 이러한 구조체로 전달되는 버퍼를 위해 헤더 혹은 꼬리 패딩의 바이트 수를 산출한다:

  • HeaderPadding = CurrentBuffer - StartBuffer

  • TailPadding = EndBuffer - (CurrentBuffer + CurrentLength)

NDISWAN은 항상 드라이버가 초기화하는 동안 OID_WAN_GET_INFO 쿼리에 대한 응답으로 리턴할 때 적어도 얼마나 많은 헤더와 꼬리 패딩이 있는지를 제공한다.

MiniportWanSend 함수는 이러한 식으로 버퍼 데이터를 다룰 수 있다. MiniportWanSend 함수로부터 NDIS_STATUS_PENDING이외의 상태를 리턴함으로써 혹은 NdisMWanSendComplete 함수를 호출함으로써 주어진 보내기 패킷이 완성될 때까지, NIC 드라이버는 주어진 패킷과 ProtocolReservedX 멤버들을 제외한 지정된 모든 것에 대한 소유권을 유지한다.(retains)

WAN 특정 모든 시스템 정의된 OID들에 대한 더 자세한 정보는, Part 2를 봐라.