NDIS_PD_QUERY_QUEUE_DEPTH 콜백 함수(ndis.h)

PD(PacketDirect) 플랫폼은 PD 지원 미니포트 드라이버의 PDQueryQueueDepth 함수를 호출하여 큐에 게시된 처리되지 않은 PD_BUFFER 구조의 수를 반환합니다.

구문

NDIS_PD_QUERY_QUEUE_DEPTH NdisPdQueryQueueDepth;

VOID() NdisPdQueryQueueDepth(
  [in]  const NDIS_PD_QUEUE *Queue,
  [out] ULONG64 *Depth
)
{...}

매개 변수

[in] Queue

전송 또는 수신 큐에 대한 포인터입니다.

[out] Depth

수신 큐에서 들어오는 패킷을 배치하는 데 사용할 수 있는 PD_BUFFER 구조의 수입니다. 예를 들어 10개의 버퍼가 게시되었고 10개 중 3개가 들어오는 패킷을 배치하기 위해 공급자가 이미 가져온 경우 이 값은 7이어야 합니다. 전송 큐에서 공급자가 전송을 위해 큐에서 아직 가져오지 않은 PD_BUFFER 구조의 수입니다.

반환 값

이 콜백 함수는 값을 반환하지 않습니다.

설명

예

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

NDIS_PD_QUERY_QUEUE_DEPTH MyPDQueryQueueDepth;

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

_Use_decl_annotations_
VOID
 MyPDQueryQueueDepth(
    CONST NDIS_PD_QUEUE*  Queue,
    ULONG64*  Depth
    )
  {...}

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

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

요구 사항