NdisFReturnNetBufferLists 함수(ndis.h)

아티클
08/07/2023

필터 드라이버는 NdisFReturnNetBufferLists 를 호출하여 하나 이상의 NET_BUFFER_LIST 구조체 및 관련 NET_BUFFER 구조체의 소유권을 해제합니다.

구문

void NdisFReturnNetBufferLists(
  [in] NDIS_HANDLE      NdisFilterHandle,
  [in] PNET_BUFFER_LIST NetBufferLists,
  [in] ULONG            ReturnFlags
);

매개 변수

[in] NdisFilterHandle

이 필터 모듈을 식별하는 NDIS 핸들입니다. NDIS는 FilterAttach 함수 호출에서 필터 드라이버에 핸들을 전달했습니다.

[in] NetBufferLists

기본 드라이버로 반환될 NET_BUFFER_LIST 구조체의 연결된 목록에 대한 포인터입니다. 연결된 목록에는 에 대한 여러 이전 호출의 NET_BUFFER_LIST 구조가 포함될 수 있습니다. FilterReceiveNetBufferLists 함수입니다 .

[in] ReturnFlags

OR 작업과 결합할 수 있는 NDIS 플래그입니다. 모든 플래그를 지우려면 이 멤버를 0으로 설정합니다. 이 함수는 다음 플래그를 지원합니다.

NDIS_RETURN_FLAGS_DISPATCH_LEVEL

현재 IRQL이 DISPATCH_LEVEL 지정합니다. 이 플래그에 대한 자세한 내용은 디스패치 IRQL 추적을 참조하세요.

NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE

이 플래그가 설정되면 NET_BUFFER_LIST 구조의 연결된 목록에 있는 모든 패킷은 동일한 Hyper-V 확장 가능한 스위치 원본 포트에서 시작됩니다.

자세한 내용은 Hyper-V 확장 가능한 스위치 보내기 및 받기 플래그를 참조하세요.

참고연결된 NET_BUFFER_LIST 구조 목록의 각 패킷이 동일한 원본 포트를 사용하는 경우 확장은 요청을 보낼 때 NdisFIndicateReceiveNetBufferLists의 ReceiveFlags 매개 변수에서 NDIS_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE 플래그를 설정해야 합니다.

반환 값

없음

설명

NDIS가 에 전달한 ReceiveFlags 매개 변수의 NDIS_RECEIVE_FLAGS_RESOURCES 플래그인 경우 FilterReceiveNetBufferLists 함수가 설정되지 않았습니다. 필터 드라이버는 NdisFReturnNetBufferLists 함수를 호출하여 NET_BUFFER_LIST 구조 및 관련 데이터를 반환해야 합니다. 필터 드라이버가 NdisFReturnNetBufferLists를 호출한 후 NDIS는 데이터를 기본 드라이버에 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.0 이상에서 지원됩니다.
대상 플랫폼	데스크톱
머리글	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	Irql_Filter_Driver_Function(ndis)