MINIPORT_PROCESS_SG_LIST 콜백 함수(ndis.h)
버스 마스터 미니포트 드라이버는 네트워크 데이터에 대한 분산/수집 목록을 처리하는 MiniportProcessSGList 함수를 제공합니다.
통사론
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은 NdisMAllocateNetBufferSGListNDIS가 반환되기 전이나 후에 MiniportProcessSGList 호출할 수 있습니다. 따라서 드라이버 작성기는 NdisMAllocateNetBufferSGList컨텍스트 내에서 호출이 수행된다고 가정해서는 안 됩니다.
NDIS는 IRQL = DISPATCH_LEVEL MiniportProcessSGList 호출합니다.
예제
MiniportProcessSGList 함수를 정의하려면 먼저 정의하는 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버 , SDV(정적 드라이버 검증 도구) 및 기타 확인 도구에 대한 코드 분석을데 도움이 되며 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 |