MINIPORT_INTERRUPT_DPC 콜백 함수(ndis.h)

아티클
03/08/2023

미니포트 드라이버는 드라이버가 NdisMRegisterInterruptEx 함수를 호출하여 인터럽트를 등록하는 경우 MiniportInterruptDPC 함수를 제공해야 합니다.

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

구문

MINIPORT_INTERRUPT_DPC MiniportInterruptDpc;

void MiniportInterruptDpc(
  [in] NDIS_HANDLE MiniportInterruptContext,
  [in] PVOID MiniportDpcContext,
  [in] PVOID ReceiveThrottleParameters,
  [in] PVOID NdisReserved2
)
{...}

매개 변수

[in] MiniportInterruptContext

인터럽트 컨텍스트 정보 블록에 대한 핸들입니다. 미니포트 드라이버는 미니포트 드라이버가 에 전달한 MiniportInterruptContext 매개 변수에 이 핸들을 제공했습니다. NdisMRegisterInterruptEx 함수입니다.

[in] MiniportDpcContext

미니포트 드라이버가 NdisMQueueDpcEx 또는 NdisMQueueDpc 함수를 호출할 때 제공한 컨텍스트 영역에 대한 포인터입니다. 미니포트 드라이버가 MiniportInterrupt 함수의 TargetProcessors 매개 변수에 비트 마스크를 반환했기 때문에 NDIS가 MiniportInterruptDPC 라고 하는 경우 MiniportDpcContext 는 NULL입니다.

[in] ReceiveThrottleParameters

에 대한 포인터 NDIS_RECEIVE_THROTTLE_PARAMETERS 구조체입니다. 이 구조체는 미니포트 드라이버가 DPC에 표시해야 하는 NET_BUFFER_LIST 구조체의 최대 수를 지정합니다.

[in] NdisReserved2

NDIS용으로 예약되었습니다.

반환 값

없음

설명

NdisMRegisterInterruptEx 함수에 인터럽트를 등록하는 미니포트 드라이버는 MiniportInterruptDPC 함수를 제공해야 합니다.

NDIS는 MiniportInterruptDPC 를 호출하여 인터럽트의 지연 처리를 완료합니다. 미니포트 드라이버는 NdisMQueueDpcEx 또는 NdisMQueueDpc 함수를 호출하여 다른 프로세서에 대한 추가 DPC(지연 프로시저 호출)를 요청할 수 있습니다.

미니포트 드라이버는 각 인터럽트 원본을 결정하고 적절한 조치를 취합니다. 예를 들어 인터럽트에서 전송 작업의 완료를 나타내는 경우 미니포트 드라이버는 보류 중인 송신 요청을 완료합니다. 인터럽트 원본이 링크 상태의 변경인 경우 미니포트 드라이버는 NDIS에 상태 새 링크를 나타냅니다. 미해결 수신 패킷이 있는 경우 미니포트 드라이버는 NDIS에 대한 패킷을 나타냅니다.

RSS(수신 측 크기 조정)를 지원하고 기능이 사용하도록 설정된 미니포트 드라이버는 MiniportInterruptDPC에서 수신 큐를 검사합니다. NIC가 이러한 기능을 제공하는 경우 NIC는 해시 값을 기반으로 별도의 큐에서 수신된 패킷을 이미 큐에 대기했을 수 있습니다. 그렇지 않으면 미니포트 드라이버는 MiniportInterruptDPC에서 패킷을 별도의 큐로 정렬할 수 있습니다.

MiniportInterruptDPC 는 NdisMIndicateReceiveNetBufferLists 함수는 현재 프로세서의 패킷을 나타냅니다. MiniportInterruptDPC 는 다른 CPU에 필요한 처리를 식별하고 DPC가 처리되지 않는 CPU에서 DPC를 예약하도록 NDIS를 요청할 수 있습니다.

현재 DPC가 MiniportInterrupt 함수와 동일한 CPU에서 실행되는 경우 미니포트 드라이버는 CPU에 매핑할 수 없는 모든 패킷을 나타내야 합니다. 이 DPC가 마지막으로 예약된 DPC이고 추가 DPC를 요청하지 않는 경우 MiniportInterruptDPC 는 반환하기 전에 NIC에서 인터럽트를 다시 활성화해야 합니다.

인터럽트는 일반적으로 NDIS가 MiniportInterruptDPC를 호출하기 전에 MiniportInterrupt 함수의 NIC에서 이미 비활성화됩니다. 컨트롤을 반환하기 전에 MiniportInterruptDPC 는 인터럽트를 다시 활성화할 수 있습니다. 인터럽트 사용 안 함으로 설정된 동안 미니포트 드라이버가 추가 DPC를 큐에 대기하는 경우 마지막 DPC가 반환되기 전에 드라이버에서 인터럽트 사용을 설정해야 합니다.

미니포트 드라이버는 인터럽트 DPC 일괄 처리를 처리하는 동안 나타내는 수신 버퍼의 수를 제한하여 필요한 시간 제한 내에서 완료해야 합니다. 인터럽트 DPC 일괄 처리는 ISR 이후와 인터럽트를 다시 활성화하기 전에 실행되는 모든 DPC의 컬렉션입니다.

미니포트 드라이버는 다음을 호출할 수 있습니다.MiniportInitializeEx 또는 MiniportHaltEx 함수의 NdisMDeregisterInterruptEx 함수는 NdisMRegisterInterruptEx로 할당된 리소스를 해제합니다. NdisMDeregisterInterruptEx가 반환되면 NDIS는 미니포트 드라이버의 MiniportInterrupt 또는 MiniportInterruptDPC 함수를 호출하지 않습니다.

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

예

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

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

MINIPORT_INTERRUPT_DPC MyInterruptDPC;

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

_Use_decl_annotations_
VOID
 MyInterruptDPC(
    NDIS_HANDLE  MiniportInterruptContext,
    PVOID  MiniportDpcContext,
    PVOID  ReceiveThrottleParameters,
    PVOID  NdisReserved2
    )
  {...}

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

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

요구 사항

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