FwpsAllocateNetBufferAndNetBufferList0 함수(fwpsk.h)
FwpsAllocateNetBufferAndNetBufferList0 함수는 새 NET_BUFFER_LIST 구조를 할당합니다.
통사론
NTSTATUS FwpsAllocateNetBufferAndNetBufferList0(
[in] NDIS_HANDLE poolHandle,
[in] USHORT contextSize,
[in] USHORT contextBackFill,
[in, optional] MDL *mdlChain,
[in] ULONG dataOffset,
[in] SIZE_T dataLength,
[out] NET_BUFFER_LIST **netBufferList
);
매개 변수
[in] poolHandle
NdisAllocateNetBufferListPool 함수에 대한 이전 호출에서 가져온 NET_BUFFER_LIST 풀 핸들입니다.
[in] contextSize
설명선 드라이버에 대해 예약할 NET_BUFFER_LIST_CONTEXT 구조에서 사용된 데이터 공간의 크기(바이트)입니다. 이 매개 변수의 값은 MEMORY_ALLOCATION_ALIGNMENT정의된 값의 배수여야 합니다.
[in] contextBackFill
설명선 드라이버에 필요한 사용되지 않는 데이터 공간(백필 공간)의 크기(바이트)입니다. FwpsAllocateNetBufferAndNetBufferList0 함수는 이 값을 ContextSize 매개 변수에 지정된 값에 추가하고 추가 공간을 할당합니다. 이 매개 변수의 값은 MEMORY_ALLOCATION_ALIGNMENT정의된 값의 배수여야 합니다.
[in, optional] mdlChain
미리 할당된 NET_BUFFER 구조를 초기화하는 데 사용되는 MDL 체인에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다.
[in] dataOffset
버퍼 시작부터 MDL 체인의 사용된 데이터 공간 시작까지의 초기 오프셋(바이트)입니다. 이 오프셋보다 앞의 데이터 공간은 사용되지 않는 데이터 공간입니다. 따라서 이 값은 MDL 체인에서 사용 가능한 백필 공간의 초기 크기도 나타냅니다.
[in] dataLength
MDL 체인에서 사용된 데이터 공간의 길이(바이트)입니다.
[out] netBufferList
새 NET_BUFFER_LIST 구조체에 대한 포인터를 받는 변수에 대한 포인터입니다.
반환 값
FwpsAllocateNetBufferAndNetBufferList0 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
|
새 NET_BUFFER_LIST 구조가 성공적으로 할당되었습니다. |
|
오류가 발생했습니다. |
발언
설명선 드라이버는 FwpsAllocateNetBufferAndNetBufferList0 함수를 호출하여 새 NET_BUFFER_LIST 구조를 할당합니다.
이 함수는 NdisAllocateNetBufferAndNetBufferList 함수이지만 WFP 패킷 주입 함수에서 사용하기 위해 특수화되어.
새 NET_BUFFER_LIST 구조에 의해 설명된 데이터가 네트워크 스택에 성공적으로 삽입된 후 설명선 드라이버는 다음을 호출하여 새 NET_BUFFER_LIST 구조를 해제합니다. FwpsFreeNetBufferList0 함수입니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista부터 사용할 수 있습니다. |
| 대상 플랫폼 | 보편적 |
| 헤더 | fwpsk.h(Fwpsk.h 포함) |
| 라이브러리 | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |