피드백

MINIPORT_PROCESS_SG_LIST 콜백 함수(ndis.h)

  • 아티클
  • 읽는 데 4분 걸림

버스 마스터 미니포트 드라이버는 네트워크 데이터에 대한 분산/수집 목록을 처리하는 MiniportProcessSGList 함수를 제공합니다.

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

구문

MINIPORT_PROCESS_SG_LIST MiniportProcessSgList;

void MiniportProcessSgList(
  [in] PDEVICE_OBJECT pDO,
  [in] PVOID Reserved,
  [in] PSCATTER_GATHER_LIST pSGL,
  [in] PVOID Context
)
{...}

매개 변수

[in] pDO

미니포트 드라이버는 이 매개 변수를 무시해야 합니다.

[in] Reserved

미니포트 드라이버는 이 매개 변수를 무시해야 합니다.

[in] pSGL

분산/수집 목록 버퍼에 대한 포인터입니다. 이는 반드시 NdisMAllocateNetBufferSGList 함수 호출에서 드라이버가 지정한 버퍼와 동일하지는 않습니다.

[in] Context

NdisMAllocateNetBufferSGList를 호출하기 전에 미니포트 드라이버가 만든 컨텍스트 영역에 대한 포인터입니다.

반환 값

없음

설명

미니포트 드라이버는 NdisMRegisterScatterGatherDma 함수를 호출하여 MiniportProcessSGList 함수를 등록합니다 . 미니포트 드라이버가 NdisMAllocateNetBufferSGList 를 호출하여 분산/수집 목록을 만들 때 NDIS는 HAL을 호출하여 목록을 만듭니다.

NdisMAllocateNetBufferSGList가 성공하면 NDIS는 미니포트 드라이버의 MiniportProcessSGList 함수를 호출합니다. 그러나 해당 함수의 성공 반환이 콜백이 이미 호출되었음을 보장하지는 않습니다. 비동기적으로 호출할 수 있습니다.

NDIS가 MiniportProcessSGList를 호출하는 경우 드라이버는 하드웨어에 NET_BUFFER 구조를 보낼 수 있습니다. MiniportProcessSGList는 분산/수집 목록의 실제 주소를 NIC의 DMA에 제출하고 NIC에 보내기 명령을 실행합니다.

HAL은 NdisMAllocateNetBufferSGList에서 NDIS가 반환되기 전이나 후에 MiniportProcessSGList를 호출할 수 있습니다. 따라서 드라이버 작성기는 NdisMAllocateNetBufferSGList의 컨텍스트 내에서 호출이 수행된다고 가정해서는 안 됩니다.

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

예제

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

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

MINIPORT_PROCESS_SG_LIST MyProcessSGList;

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

_Use_decl_annotations_
VOID
 MyProcessSGList(
    PDEVICE_OBJECT  pDO,
    PVOID  Reserved,
    PSCATTER_GATHER_LIST  pSGL,
    PVOID  Context
    )
  {...}

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

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

요구 사항

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

참조

NdisMAllocateNetBufferSGList

NdisMRegisterScatterGatherDma