NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체(ndischimney.h)

아티클
08/07/2023

[TCP 굴뚝 오프로드 기능은 더 이상 사용되지 않으며 사용하면 안 됩니다.]

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조는 TCP 굴뚝 오프로드 상태 트리의 기본 구성 요소입니다. 오프로드 상태 트리에는 하나 이상의 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체가 포함될 수 있습니다.

구문

typedef struct _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST {
  IN NDIS_OBJECT_HEADER                Header;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *NextBlock;
#if ...
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
  IN _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST *DependentBlockList;
#else
  struct                               _NDIS_MINIPORT_OFFLOAD_BLOCK_LIST;
#endif
  OUT NDIS_STATUS                      Status;
  IN PVOID                             NdisReserved[2];
  IN OUT PVOID                         *MiniportOffloadContext;
  IN NDIS_HANDLE                       NdisOffloadHandle;
  IN PVOID                             ProtocolReserved[2];
  IN PVOID                             MiniportReserved[2];
  IN PVOID                             ImReserved[2];
  IN PVOID                             Scratch[2];
  IN PVOID                             SourceHandle;
  IN NDIS_PORT_NUMBER                  PortNumber;
  IN OUT PNET_BUFFER_LIST              NetBufferListChain;
} NDIS_MINIPORT_OFFLOAD_BLOCK_LIST, *PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST;

멤버

Header

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체의 헤더입니다. 헤더는 NDIS_OBJECT_HEADER 구조체로 서식이 지정됩니다. NDIS_OBJECT_HEADER 구조체에는 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체의 수정 버전 번호, 메모리의 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조 바로 뒤의 오프로드 상태 유형 및 헤더를 포함한 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체의 크기(바이트)가 포함됩니다.

NDIS_OBJECT_HEADER 구조체의 Type 멤버는 오프로드 상태의 형식을 나타내며, 메모리의 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조 바로 뒤에 있는 특정 오프로드 상태 구조체(또는 구조체)를 의미합니다.

지원되는 OFFLOAD_STATE_TYPE 값은 다음과 같습니다.

NeighborOffloadConstState

상수 인접 상태를 지정합니다. 이 상태는 로 형식이 지정됩니다. NEIGHBOR_OFFLOAD_STATE_CONST 구조체입니다.

NeighborOffloadCachedState

캐시된 인접 상태를 지정합니다. 이 상태는 로 형식이 지정됩니다. NEIGHBOR_OFFLOAD_STATE_CACHED 구조체입니다.

NeighborOffloadDelegatedState

위임된 인접 상태를 지정합니다. 이 상태는 로 형식이 지정됩니다. NEIGHBOR_OFFLOAD_STATE_DELEGATED 구조체입니다.

NeighborOffloadState

상수, 캐시됨 및 위임된 인접 상태를 포함하여 모든 인접 상태 정보를 지정합니다. 이 상태는 NEIGHBOR_OFFLOAD_STATE_CONST 구조체로 형식이 지정되고 NEIGHBOR_OFFLOAD_STATE_CACHED 구조와 NEIGHBOR_OFFLOAD_STATE_DELEGATED 구조가 뒤따릅니다.

Ip4OffloadConstState

상수 경로 상태(IPv4)를 지정합니다. 이 상태는 로 형식이 지정됩니다. PATH_OFFLOAD_STATE_CONST 구조체입니다.

Ip4OffloadCachedState

캐시된 경로 상태(IPv4)를 지정합니다. 이 상태는 로 형식이 지정됩니다. PATH_OFFLOAD_STATE_CACHED 구조체입니다.

Ip4OffloadDelegatedState

위임된 경로 상태(IPv4)를 지정합니다. 이 상태는 로 형식이 지정됩니다. PATH_OFFLOAD_STATE_DELEGATED 구조체입니다. 현재 위임된 경로 상태가 없습니다. PATH_OFFLOAD_STATE_DELEGATED 구조체에는 변수가 없습니다.

Ip4OffloadState

상수, 캐시된 경로 상태 및 위임된 경로 상태를 포함하여 모든 경로 상태(IPv4)를 지정합니다. 이 상태는 PATH_OFFLOAD_STATE_CONST 구조로 형식이 지정되고 PATH_OFFLOAD_STATE_CACHED 구조와 PATH_OFFLOAD_STATE_DELEGATED 구조가 뒤따릅니다.

Ip6OffloadConstState

상수 경로 상태(IPv6)를 지정합니다. 이 상태는 PATH_OFFLOAD_STATE_CONST 구조체로 형식이 지정됩니다.

Ip6OffloadCachedState

캐시된 경로 상태(IPv6)를 지정합니다. 이 상태는 PATH_OFFLOAD_STATE_CACHED 구조체로 서식이 지정됩니다.

Ip6OffloadDelegatedState

위임된 경로 상태(IPv6)를 지정합니다. 이 상태는 PATH_OFFLOAD_STATE_DELEGATED 구조체로 형식이 지정됩니다. 현재 위임된 경로 상태가 없습니다. PATH_OFFLOAD_STATE_DELEGATED 구조체에는 변수가 없습니다.

Ip6OffloadState

상수, 캐시된 경로 및 위임된 경로 상태를 포함하여 모든 경로 상태 정보(IPv6)를 지정합니다. 이 상태는 PATH_OFFLOAD_STATE_CONST 구조로 형식이 지정되고 PATH_OFFLOAD_STATE_CACHED 구조와 PATH_OFFLOAD_STATE_DELEGATED 구조가 뒤따릅니다.

TcpOffloadConstState

상수 TCP 상태를 지정합니다. 이 상태는 로 형식이 지정됩니다. TCP_OFFLOAD_STATE_CONST 구조체입니다.

TcpOffloadCachedState

캐시된 TCP 상태를 지정합니다. 이 상태는 로 형식이 지정됩니다. TCP_OFFLOAD_STATE_CACHED 구조체입니다.

TcpOffloadDelegatedState

위임된 TCP 상태를 지정합니다. 이 상태는 로 형식이 지정됩니다. TCP_OFFLOAD_STATE_DELEGATED 구조체입니다.

TcpOffloadResourceState

예약되어 있습니다. 이 OFFLOAD_STATE_TYPE 값과 TCP_OFFLOAD_RESOURCE_STATE 구조체는 현재 사용되지 않습니다.

TcpOffloadState

상수, 캐시됨 및 위임된 TCP 상태를 포함하여 모든 TCP 상태 정보를 지정합니다. 이 상태는 TCP_OFFLOAD_STATE_CONST 구조체로 형식이 지정되고 TCP_OFFLOAD_STATE_CACHED 구조와 TCP_OFFLOAD_STATE_DELEGATED 구조가 뒤따릅니다.

FilterReservedOffloadState

필터 드라이버용으로 예약되어 있습니다.

NextBlock

헤더 멤버의 Type 멤버가 나타내는 오프로드 상태 계층(인접, 경로 또는 TCP)의 다음 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체에 대한 포인터입니다. NextBlock 포인터를 통해 연결된 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체는 항상 오프로드 상태의 동일한 계층에 있습니다. NULL의 NextBlock 값은 이 수준에서 추가적인 다음 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체가 없음을 나타냅니다.

_NDIS_MINIPORT_OFFLOAD_BLOCK_LIST

DependentBlockList

오프로드 상태의 종속 계층(오프로드 상태 트리의 상위 계층)에 있는 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체에 대한 포인터입니다. TCP 굴뚝 오프로드의 경우:

인접 계층에 있는 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체의 DependentBlockList 멤버는 경로 계층의 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조만 가리킬 수 있습니다.
경로 계층에 있는 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체의 DependentBlockList 멤버는 TCP 계층의 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조만 가리킬 수 있습니다.
TCP 계층에서 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체의 DependentBlockList 멤버는 항상 NULL입니다.

DependentBlockList 값이 NULL이면 종속 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체가 없음을 나타냅니다.

Status

오프로드 시작, 쿼리 오프로드, 오프로드 업데이트, 오프로드 무효화 또는 오프로드 종료 작업의 완료 상태 오프로드 대상이 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조와 연결되거나 참조되는 상태에서 수행되는 오프로드 작업을 종료합니다. 작업에 따라 오프로드 대상은 다음 NDIS_STATUS 값 중 하나를 Status 멤버에 씁니다.

NDIS_STATUS_SUCCESS

오프로드 시작: 오프로드 대상이 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조와 연결된 상태와 즉시 종속된 모든 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체와 연결된 상태를 성공적으로 오프로드했습니다.

오프로드 쿼리, 업데이트, 무효화 또는 종료: 오프로드 대상이 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조와 연결되거나 참조되는 상태에서 작업을 성공적으로 수행했습니다.

NDIS_STATUS_OFFLOAD_PARTIAL_SUCCESS

오프로드 시작: 오프로드 대상이 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체와 연결된 상태를 오프로드했지만 즉시 종속된 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체 중 하나 이상과 연결된 상태를 오프로드하지 못했습니다.