NdisAdvanceNetBufferDataStart 함수(ndis/nblapi.h)

NdisAdvanceNetBufferDataStart 함수를 호출하여 NdisRetreatNetBufferDataStart 함수와 함께 추가된 사용된 데이터 공간을 해제합니다.

구문

NDIS_EXPORTED_ROUTINE VOID NdisAdvanceNetBufferDataStart(
  [in]           NET_BUFFER          *NetBuffer,
  [in]           ULONG               DataOffsetDelta,
  [in]           BOOLEAN             FreeMdl,
  [in, optional] NET_BUFFER_FREE_MDL *FreeMdlHandler
);

매개 변수

[in] NetBuffer

이전에 할당된 NET_BUFFER 구조체에 대한 포인터입니다.

[in] DataOffsetDelta

릴리스할 사용된 데이터 공간 의 양입니다. NDIS는 그에 따라 NET_BUFFER 구조체의 DataOffset 멤버 값을 조정합니다.

[in] FreeMdl

TRUE이면 사전 작업에서 사용되지 않는 모든 MDL을 해제하도록 NDIS에 요청하는 부울 값입니다. FreeMdl이 FALSE이면 NDIS는 후속 퇴각 작업에 사용하기 위해 사용되지 않는 MDL을 유지합니다.

[in, optional] FreeMdlHandler

NetFreeMdl 함수에 대한 선택적 진입점입니다. 호출자가 NetFreeMdl 함수의 진입점을 지정하는 경우 NDIS는 NetFreeMdl 을 호출하여 MDL 및 메모리를 해제합니다.

반환 값

없음

설명

NDIS가 NdisRetreatNetBufferDataStart 함수에 대한 해당 호출을 충족하기 위해 메모리를 할당한 경우 NdisAdvanceNetBufferDataStart 는 NdisRetreatNetBufferDataStart 가 할당한 메모리를 해제합니다. 그렇지 않으면 메모리가 MDL에 유지되고 NET_BUFFER 구조체의 DataOffset 멤버 값만 수정됩니다.

NDIS는 NdisAdvanceNetBufferDataStart에서 메모리를 해제해야 하는 경우 FreeMdl에 지정된 NetFreeMdl 함수를 호출합니다. NDIS는 NetFreeMdl 을 호출하여 드라이버가 NetAllocateMdl 함수에 할당한 MDL 및 메모리를 해제합니다.

프로토콜 드라이버가 수신 경로에서 NdisAdvanceNetBufferDataStart 를 호출하여 다양한 전송 헤더에 액세스하는 경우 MDL 체인을 수정하면 안 되며 FreeMdl 은 FALSE입니다.

요구 사항

지원되는 최소 클라이언트	NDIS 6.0 이상에서 지원됩니다.
대상 플랫폼	유니버설
헤더	ndis/nblapi.h(ndis.h 포함)
라이브러리	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	Irql_NetBuffer_Function(ndis)

참고 항목

NET_BUFFER

NdisRetreatNetBufferDataStart

NetAllocateMdl

NetFreeMdl