W_QUERY_OFFLOAD_HANDLER 콜백 함수(ndischimney.h)

아티클
08/07/2023

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

MiniportQueryOffload 함수는 이전에 오프로드된 TCP 굴뚝 상태 개체를 쿼리합니다.

구문

W_QUERY_OFFLOAD_HANDLER WQueryOffloadHandler;

void WQueryOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

매개 변수

[in] MiniportAdapterContext

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

[in, out] OffloadBlockList

에 대한 포인터 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체- 이러한 구조체의 연결된 목록의 루트가 될 수 있습니다. 이러한 구조체는 쿼리 중인 오프로드된 상태를 식별합니다.

반환 값

없음

설명

MiniportQueryOffload 함수는 오프로드 대상에 오프로드된 모든 TCP 굴뚝 상태를 쿼리할 수 있습니다.

MiniportQueryOffload 함수는 OffloadBlockList 포인터를 저장한 다음 를 반환합니다. 오프로드 대상은 항상 를 호출하여 쿼리 작업을 비동기적으로 완료합니다. NdisMQueryOffloadStateComplete 함수입니다. OffloadBlockList 포인터는 을 가리킵니다. NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 독립 실행형 구조 또는 오프로드 상태 트리의 루트 노드일 수 있는 구조체입니다. 상태 트리는 오프로드 대상이 NdisMQueryOffloadStateComplete 함수를 호출할 때까지 유효합니다.

MiniportQueryOffload 함수에서 반환한 후 미니포트 드라이버는 OffloadBlockList 포인터가 가리키는 상태 트리의 각 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조와 연결된 오프로드 상태 구조를 채웁니다. 이러한 각 오프로드 상태 구조에 미니포트 드라이버는 구조체에 있는 각 변수의 현재 값을 씁니다.

NdisMQueryOffloadStateComplete 함수를 호출하기 전에 오프로드 대상은 다음 NDIS_STATUS 값 중 하나를 상태 트리의 각 NDIS_MINIPORT_OFFLOAD_BLOCK_LIST 구조체의 Status 멤버에 기록해야 합니다.