다음을 통해 공유

NDIS_PD_ALLOCATE_COUNTER 콜백 함수(ndis.h)

  • 아티클

PD(PacketDirect) 플랫폼은 PD 지원 미니포트 드라이버의 NdisPDAllocateCounter 함수를 호출하여 카운터 개체를 할당합니다. 카운터에는 세 가지 종류가 있습니다.

  • 수신 큐 카운터는 수신 큐 활동을 추적하는 데 사용됩니다.
  • 전송 큐 카운터는 전송 큐 활동을 추적하는 데 사용됩니다.
  • 필터 카운터는 필터 일치 작업을 추적하는 데 사용됩니다.
참고NDIS_PD_ALLOCATE_COUNTER 형식을 사용하여 함수를 선언해야 합니다. 자세한 내용은 다음 예제 섹션을 참조하세요.
 

통사론

NDIS_PD_ALLOCATE_COUNTER NdisPdAllocateCounter;

NTSTATUS() NdisPdAllocateCounter(
  [in]  NDIS_PD_PROVIDER_HANDLE ProviderHandle,
  [in]  const NDIS_PD_COUNTER_PARAMETERS *CounterParameters,
  [out] NDIS_PD_COUNTER_HANDLE *CounterHandle
)
{...}

매개 변수

[in] ProviderHandle

PD 지원 미니포트 드라이버의 공급자 개체를 식별하는 공급자 핸들입니다.

[in] CounterParameters

카운터 형식과 같은 정보를 지정하는 NDIS_PD_COUNTER_PARAMETERS 구조체입니다.

[out] CounterHandle

드라이버 할당 카운터 핸들 변수에 대한 포인터입니다. 카운터 할당에 성공하면 미니포트 드라이버는 이 변수에서 새로 할당된 카운터에 대한 핸들을 반환합니다.

반환 값

NdisPDAllocateCounter 다음 상태 값 중 하나를 반환할 수 있습니다.

반환 코드 묘사
STATUS_SUCCESS
 미니포트 드라이버는 카운터를 성공적으로 할당하고 CounterHandle 매개 변수에 핸들을 반환했습니다.
STATUS_INSUFFICIENT_RESOURCES
 리소스 부족으로 인해 할당에 실패했습니다.

발언

동일한 카운터 개체를 카운터와 동일한 형식의 여러 큐 또는 필터 개체와 연결할 수 있습니다. 예를 들어 수신 큐가 5개(RQ1~RQ5)이 있고 수신 카운터 2개(RC1 및 RC2)가 있는 경우 수신 카운터 RC1은 수신 큐 RQ1, RQ2, RQ3 및 수신 카운터 RC2를 수신 큐 RQ4 및 RQ5와 연결할 수 있습니다.

예제

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

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

NDIS_PD_ALLOCATE_COUNTER MyPDAllocateCounter;

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

_Use_decl_annotations_
NTSTATUS
 MyPDAllocateCounter(
    NDIS_PD_PROVIDER_HANDLE  ProviderHandle,
    CONST NDIS_PD_COUNTER_PARAMETERS*  CounterParameters,
    NDIS_PD_COUNTER_HANDLE*  CounterHandle
    )
  {...}

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

Use_decl_annotations대한 자세한 내용은 함수 동작 주석참조하세요.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows 10
지원되는 최소 서버 Windows Server 2016
대상 플랫폼 Windows
헤더 ndis.h
IRQL PASSIVE_LEVEL

참고 항목

NDIS_PD_COUNTER_PARAMETERS

NdisPDFreeCounter