MINIPORT_MESSAGE_INTERRUPT_DPC 콜백 함수(ndis.h)

아티클
03/08/2023

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

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

구문

MINIPORT_MESSAGE_INTERRUPT_DPC MiniportMessageInterruptDpc;

void MiniportMessageInterruptDpc(
  [in] NDIS_HANDLE MiniportInterruptContext,
  [in] ULONG MessageId,
  [in] PVOID MiniportDpcContext,
  [in] PVOID ReceiveThrottleParameters,
       PVOID NdisReserved2 PULONG NdisReserved1,
  [in] PULONG NdisReserved2
)
{...}

매개 변수

[in] MiniportInterruptContext

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

[in] MessageId

MSI(메시지 신호 인터럽트) 메시지 식별자입니다. MessageId 는 에 대한 인덱스입니다. IO_INTERRUPT_MESSAGE_INFO_ENTRY 구조체 IO_INTERRUPT_MESSAGE_INFO 구조체입니다. 드라이버가 NdisMRegisterInterruptEx 함수를 사용하여 MSI에 성공적으로 등록되면 NDIS는 MessageInfoTable 멤버의 연결된 IO_INTERRUPT_MESSAGE_INFO 구조체에 대한 포인터를 전달합니다.

[in] MiniportDpcContext

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

[in] ReceiveThrottleParameters

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

참고 NDIS 6.1 이하에서 이 매개 변수의 이름은 NdisReserved1이고 해당 데이터 형식은 PULONG이며 NDIS용으로 예약되어 있습니다.

NdisReserved1

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

[in] NdisReserved2

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

참고 NDIS 6.1 이하에서 이 매개 변수의 데이터 형식은 PULONG입니다.

반환 값

없음

설명

메시지 신호 인터럽트를 NdisMRegisterInterruptEx 함수에 등록하는 미니포트 드라이버는 MiniportMessageInterruptDPC 함수를 제공해야 합니다.

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

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

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

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

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

NDIS가 MiniportMessageInterruptDPC를 호출하기 전에 NIC에서 지정된 메시지에 대한 인터럽트는 일반적으로 에서 사용하지 않도록 설정되었습니다. MiniportMessageInterrupt 함수입니다. 컨트롤을 반환하기 전에 MiniportMessageInterruptDPC 는 인터럽트를 다시 활성화할 수 있습니다. 인터럽트 사용 안 함으로 설정된 동안 미니포트 드라이버가 추가 DPC를 큐에 대기하는 경우 드라이버는 마지막 DPC가 실행된 후 인터럽트 사용을 설정해야 합니다.

참고 성능을 향상시키려면 미니포트 드라이버는 특정 메시지에 대한 인터럽트만 사용하지 않도록 설정해야 합니다. 모든 메시지 신호 인터럽트는 사용하지 않도록 설정해서는 안 됩니다.

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

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

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

예

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

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

MINIPORT_MESSAGE_INTERRUPT_DPC MyMessageInterruptDPC;

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

_Use_decl_annotations_
VOID
 MyMessageInterruptDPC(
    NDIS_HANDLE  MiniportInterruptContext,
    ULONG  MessageId,
    PVOID  MiniportDpcContext,
    PVOID  ReceiveThrottleParameters,
    PVOID  NdisReserved2
    )
  {...}

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

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

요구 사항

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