MINIPORT_INTERRUPT_DPC 콜백 함수(ndis.h)

아티클
02/16/2022
읽는 데 8분 걸림

드라이버가 인터럽트를 등록하기 위해 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

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

[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(정적 드라이버 검증 도구) 및 기타 확인 도구에 대한 Code Analysis 오류를 찾는 데 도움이 되며, 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