MINIPORT_CANCEL_SEND 콜백 함수(ndis.h)

아티클
08/07/2023

NDIS는 미니포트 드라이버의 MiniportCancelSend 함수를 호출하여 지정된 취소 식별자로 표시된 모든 NET_BUFFER_LIST 구조체의 전송을 취소합니다.

참고MINIPORT_CANCEL_SEND 형식을 사용하여 함수를 선언해야 합니다. 자세한 내용은 다음 예제 섹션을 참조하세요.

구문

MINIPORT_CANCEL_SEND MiniportCancelSend;

void MiniportCancelSend(
  [in] NDIS_HANDLE MiniportAdapterContext,
  [in] PVOID CancelId
)
{...}

매개 변수

[in] MiniportAdapterContext

Miniport 드라이버가 MiniportInitializeEx 함수에 할당한 컨텍스트 영역에 대한 핸들입니다. 미니포트 드라이버는 이 컨텍스트 영역을 사용하여 어댑터에 대한 상태 정보를 유지 관리합니다.

[in] CancelId

취소 식별자입니다. 이 식별자는 취소되는 NET_BUFFER_LIST 구조를 지정합니다.

반환 값

없음

설명

큐 에 NET_BUFFER_LIST 구조 체를 보내는 미니포트 드라이버 및 중간 드라이버는 MiniportCancelSend 함수를 내보 냅니다. MiniportCancelSend 함수는 지정된 NET_BUFFER_LIST 구조체의 보류 중인 전송을 취소합니다.

지나치게 NDIS 드라이버가 를 호출하는 경우 NdisCancelSendNetBufferLists 함수, NDIS는 바인딩에서 적절한 하위 수준 드라이버의 MiniportCancelSend 함수를 호출합니다. NDIS는 하위 수준 드라이버가 MiniportCancelSend 함수를 내보내는 경우에만 이 호출을 수행합니다.

미니포트 드라이버의 MiniportCancelSend 함수는 다음 작업을 수행합니다.

지정된 어댑터에 대해 큐에 대기된 NET_BUFFER_LIST 구조 목록을 트래버스하고 를 호출합니다.매크로를 NDIS_GET_NET_BUFFER_LIST_CANCEL_ID 큐에 대기된 각 NET_BUFFER_LIST 구조에 대한 취소 식별자를 가져옵니다. 미니포트 드라이버는 NDIS_GET_NET_BUFFER_LIST_CANCEL_ID 반환하는 취소 식별자와 NDIS가 MiniportCancelSend에 전달한 취소 식별자를 비교합니다.
취소 식별자가 지정된 취소 식별자와 일치하는 모든 NET_BUFFER_LIST 구조체를 송신 큐(연결 해제)에서 제거합니다.
를 호출합니다.구조체를 반환하기 위해 연결되지 않은 모든 NET_BUFFER_LIST 구조체에 대한 NdisMSendNetBufferListsComplete 함수입니다. 미니포트 드라이버는 NET_BUFFER_LIST 구조체의 상태 필드를 NDIS_STATUS_SEND_ABORTED 설정합니다.

중간 드라이버의 MiniportCancelSend 함수는 다음 작업을 수행합니다.

미니포트 드라이버의 MiniportCancelSend 함수에 대한 이전 목록에서 작업을 수행합니다.
를 호출합니다. NdisCancelSendNetBufferLists 함수는 MiniportCancelSend 호출에서 NDIS가 지정한 어댑터에 매핑되는 바인딩을 지정합니다.

NDIS는 IRQL <= DISPATCH_LEVEL MiniportCancelSend 를 호출합니다.

예

MiniportCancelSend 함수를 정의하려면 먼저 정의할 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 콜백 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버에 대한 코드 분석, SDV( 정적 드라이버 검증 도구 ) 및 기타 확인 도구에서 오류를 찾는 데 도움이 되며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.

예를 들어 " MyCancelSend"라는 MiniportCancelSend 함수를 정의하려면 이 코드 예제와 같이 MINIPORT_CANCEL_SEND 형식을 사용합니다.

MINIPORT_CANCEL_SEND MyCancelSend;

그런 다음 다음과 같이 함수를 구현합니다.

_Use_decl_annotations_
VOID
 MyCancelSend(
    NDIS_HANDLE  MiniportAdapterContext,
    PVOID  CancelId
    )
  {...}

MINIPORT_CANCEL_SEND 함수 형식은 Ndis.h 헤더 파일에 정의되어 있습니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 MINIPORT_CANCEL_SEND 함수 형식에 적용되는 주석이 사용되도록 합니다. 함수 선언 요구 사항에 대한 자세한 내용은 NDIS 드라이버에 함수 역할 형식을 사용하여 함수 선언을 참조하세요.

Use_decl_annotations 대한 자세한 내용은 함수 동작에 주석을 추가를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.0 이상에서 지원됩니다.
대상 플랫폼	Windows
헤더	ndis.h(Ndis.h 포함)
IRQL	<= DISPATCH_LEVEL