NDIS_TASK_OFFLOAD

typedef struct _NDIS_TASK_OFFLOAD

{

    ULONG      Version;

    ULONG      Size;

    NDIS_TASK  Task;

    ULONG      OffsetNextTask;

    ULONG      TaskBufferLength;

    UCHAR      TaskBuffer[1];

} NDIS_TASK_OFFLOAD, *PNDIS_TASK_OFFLOAD;

OID_TASK_TASK_OFFLOAD에 대한 응답으로 미니포트에 의해 제공될 때, NDIS_TASK_OFFLOAD 구조체는 특정 타입의 TCP/IP 전송 계층으로부터 offload된 태스크를 행하기 위한 NIC의 능력들을 지정한다. OID_TCP_TASK_OFFLOAD의 설정으로 TCP/IP 전송 계층에 의해 제공될 때, NDIS_TASK_OFFLOAD 구조체는 TCP/IP 전송계층이 가능하게 하는 offload 태스크를 지정한다.

멤버

Version
이러한 태스크-offload 능력의 버전 넘버. 만약 미니포트의 NIC이 특정 task-offload 능력의 하나의 버전 이상을 지원한다면, 각 버전의 능력은 분리된 NDIS_TASK_OFFLOAD 구조체로 가리켜야 한다. TCP/IP 전송 계층은 대부분의 가능한 적당한 버전을 선택한다.

Size
NDIS_TASK_OFFLOAD 구조체의 바이트 크기를 지정한다. Size는 sizeof(NDIS_TASK_OFFLOAD)로 설정되고 NDIS_TASK_OFFLOAD 구조체의 버전을 결정하기 위해 사용된다.

Task
다음과 같은 하나로 offload 태스크의 타입을 지정한다.

TcpIpChecksumNdisTask
Checksum offload. TaskBuffer는 NDIS_TASK_TCP_IP_CHECKSUM 구조체를 포함한다.

IpSecNdisTask
IP Security offload. TaskBuffer는 NDIS_TASK_IPSEC 구조체를 포함한다.

TcpLargeSendNdisTask
Segmentation offload. TaskBuffer는 NDIS_TASK_TCP_LARGE_SEND 구조체를 포함한다.

OffsetNextTask
InformationBuffer내에 NDIS_TASK_OFFLOAD_STRUCTURE 의 시작으로부터 다음 NDIS_TASK_OFFLOAD 구조체로 옵셋을 지정한다. 만약 이 NDIS_TASK_OFFLOAD 구조체가 InformationBuffer내 마지막 하나라면, OffsetNextTask는 0으로 설정된다.

TaskBufferLength
TaskBuffer인 구조체의 바이트 크기를 지정한다.

TaskBuffer
Task에 의해 지정된 offload 태스크 특정인 정보를 포함하는 가변 길이 배열을 지정한다. TaskBuffer의 내용들은 Task 타입에 따라 변한다.

태스크 타입 TaskBuffer의 내용
TcpIpChecksumNdisTask NDIS_TASK_TCP_IP_CHECKSUM 구조체
IpSecNdisTask NDIS_TASK_IPSEC 구조체
TcpLargeSendNdisTask NDIS_TASK_TCP_LARGE_SEND 구조체

주석

만약 NIC이 적당한 능력들을 가진다면, 마이크로소프트 TCP/IP 전송 계층은 NIC에 대해 하나 혹은 그 이상의 다음과 같은 태스크들을 offload 할 수 있다:

  • IP 혹은 TCP 체크섬들의 계산과 검증

  • IP Security 처리

  • 큰 TCP 패킷들을 더 작은 TCP 패킷들로 파편화

TCP/IP 전송 계층은 OID_TCP_TASK_OFFLOAD를 쿼리함으로써 NIC의 태스크 offload 능력들을 결정한다. 응답으로, 미니포트는 InformationBuffer로 NDIS_TASK_OFFLOAD_HEADER 구조체에 함께 하나 혹은 그 이상 NDIS_TASK_OFFLOAD 구조체들을 리턴한다. 각 NDIS_TASK_OFFLOAD 구조체의 TaskBuffer는 미니포트의 NIC에 의해 지원된 특정 태스크-offload 능력을 지정하는 태스크 특정 구조체(NDIS_TASK_TCP_IP_CHECKSUM, NDIS_TASK_IPSEC, NDIS_TASK_LARGE_SEND)를 포함한다. 만약 미니포트의 NIC이 특정 태스크-offload 능력의 다중 버전들을 지원한다면, 각 버전을 위한 하나의 NDIS_TASK_OFFLOAD 구조체를 리턴한다.

NIC의 태스크-offload 능력들을 쿼리한 후, TCP/IP 전송 계층은 OID_TCP_TASK_OFFLOAD를 설정함으로써 NIC의 태스크-offload 능력들을 가능하게 한다. 이러한 설정 연산에서, TCP/IP 전송 계층은 InformationBuffer에 NDIS_TASK_OFFLOAD_HEADER 구주체와 함께 가능인 각 offload 태스크를 위한 NDIS_TASK_OFFLOAD 구조체를 제공한다. 미니포트는 어느 offload 태스크들이 가능으로 되어 있는지 결정하기 위해 각 NDIS_TASK_OFFLOAD 구조체를 조사해야 한다. 미니포트는 또한 어느 특정 offload 태스크를 위한 특정 능력들이 가능한지를 결정하기 위해 각 NDIS_TASK_OFFLOAD 구조체의 TaskBuffer인 태스크 특정 구조체를 조사해야 한다.