W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER 콜백 함수(ndischimney.h)

아티클
08/07/2023

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

NDIS는 MiniportTcpOffloadReceiveReturn 함수를 호출하여 NET_BUFFER_LIST 및 연결된 구조체의 소유권을 오프로드 대상에 반환합니다.

구문

W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER WTcpOffloadReceiveReturnHandler;

NDIS_STATUS WTcpOffloadReceiveReturnHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

매개 변수

[in] MiniportAdapterContext

오프로드 대상이 어댑터의 이 instance 대한 상태 정보를 유지하는 오프로드 대상 할당 컨텍스트 영역에 대한 핸들입니다. 미니포트 드라이버는 호출할 때 NDIS에 이 핸들을 제공했습니다. NdisMSetMiniportAttributes 의 MiniportInitializeEx 함수입니다.

[in] NetBufferList

NET_BUFFER_LIST 구조체에 대한 포인터입니다. 이 구조체는 독립 실행형 구조체이거나 연결된 NET_BUFFER_LIST 구조 목록의 첫 번째 구조체일 수 있습니다. 연결된 목록에는 에 대한 하나 이상의 호출에서 NET_BUFFER_LIST 구조가 포함될 수 있습니다. NdisTcpOffloadReceiveHandler 함수입니다.

반환 값

MiniportTcpOffloadReceiveReturn 함수는 항상 성공해야 합니다. 따라서 MiniportTcpOffloadReceiveReturn 함수는 항상 NDIS_STATUS_SUCCESS 반환해야 합니다.

설명

NDIS는 MiniportTcpOffloadReceiveReturn 함수를 호출하여 오프로드 대상이 하나 이상의 이전 호출에서 전달한 NET_BUFFER_LIST 구조체 및 연결된 구조체의 소유권을 반환합니다. NdisTcpOffloadReceiveHandler 함수입니다.

MiniportTcpOffloadReceiveReturn 함수는 후속 수신 표시에 사용할 반환된 NET_BUFFER_LIST 구조를 준비할 수 있습니다. MiniportTcpOffloadReceiveReturn 함수는 NET_BUFFER_LIST 구조를 풀에 반환할 수 있지만(예: NdisFreeNetBufferList 함수를 호출할 수 있음) 풀로 반환하지 않고 구조를 다시 사용하는 것이 더 효율적일 수 있습니다.

오프로드 대상 드라이버는 언로드하면 안 되며 표시된 모든 수신 버퍼가 반환될 때까지 오프로드 대상 어댑터를 닫아서는 안 됩니다.