NdisAllocateNetBufferList 함수(ndis/nblapi.h)

아티클
02/07/2025

NdisAllocateNetBufferList 함수를 호출하여 NET_BUFFER_LIST 구조체 풀에서 NET_BUFFER_LIST 구조를 할당하고 초기화합니다.

통사론

NDIS_EXPORTED_ROUTINE NET_BUFFER_LIST * NdisAllocateNetBufferList(
  [in] NDIS_HANDLE PoolHandle,
  [in] USHORT      ContextSize,
  [in] USHORT      ContextBackFill
);

매개 변수

[in] PoolHandle

이전에 호출에서 반환된 NET_BUFFER_LIST 구조체 풀 핸들 NdisAllocateNetBufferListPool.

[in] ContextSize

호출자에 대해 예약할 NET_BUFFER_LIST_CONTEXT 구조에서 사용된 데이터 공간의 양입니다. ContextSize MEMORY_ALLOCATION_ALIGNMENT 정의된 값의 배수여야 합니다.

[in] ContextBackFill

호출자에게 필요한 사용되지 않는 데이터 공간(백필 공간)의 양입니다. NDIS는 이 값을 ContextSize 추가하고 추가 공간을 할당합니다. ContextBackFill MEMORY_ALLOCATION_ALIGNMENT 정의된 값의 배수여야 합니다.

반환 값

NdisAllocateNetBufferList 할당된 NET_BUFFER_LIST 구조체에 대한 포인터를 반환합니다. 할당에 실패한 경우 이 포인터는 NULL .

발언

NdisAllocateNetBufferList 또는 NdisAllocateNetBufferAndNetBufferList는 풀에서 NET_BUFFER_LIST 구조를 할당하는 함수를.

참고NET_BUFFER 및 NET_BUFFER_LIST 구조체는 NDIS 버퍼 풀에서 할당되어야 합니다. 드라이버는 프라이빗 메모리 풀 또는 스택에서 NET_BUFFER_LIST 또는 NET_BUFFER 구조를 할당하고 초기화해서는 안 합니다.

NdisAllocateNetBufferList 호출하고 NET_BUFFER_LIST 구조체 풀을 호출하여 할당한 경우 NdisAllocateNetBufferListPool은 NET_BUFFER_LIST_POOL_PARAMETERS 구조체의 fAllocateNetBuffer 멤버가 TRUE 함수를, NDIS는 NET_BUFFER_LIST, NET_BUFFER, MDL 및 데이터를 할당합니다.

NdisFreeNetBufferList 함수를 호출하여 NET_BUFFER_LIST 구조를 해제합니다.

요구 사항

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