NDIS_SWITCH_SET_NET_BUFFER_LIST_SOURCE 콜백 함수(ndis.h)
SetNetBufferListSource 함수는 NET_BUFFER_LIST 구조로 지정된 패킷에 대한 Hyper-V 확장 가능한 스위치 원본 포트 식별자 및 네트워크 어댑터 인덱스를 설정합니다.
구문
NDIS_SWITCH_SET_NET_BUFFER_LIST_SOURCE NdisSwitchSetNetBufferListSource;
NDIS_STATUS NdisSwitchSetNetBufferListSource(
[in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
PNET_BUFFER_LIST NetBufferList,
[in] NDIS_SWITCH_PORT_ID PortId,
[in] NDIS_SWITCH_NIC_INDEX NicIndex
)
{...}
매개 변수
[in] NdisSwitchContext
Hyper-V 확장 가능 스위치 확장이 연결된 확장 가능한 스위치 모듈의 핸들을 포함하는 NDIS_SWITCH_CONTEXT 값입니다. 확장이 NdisFGetOptionalSwitchHandlers를 호출하면 이 핸들은 NdisSwitchContext 매개 변수를 통해 반환됩니다.
NetBufferList
단일 패킷에 대한 NET_BUFFER_LIST 구조체에 대한 포인터입니다.
[in] PortId
확장 가능한 스위치에서 원본 포트의 고유 식별자를 지정하는 NDIS_SWITCH_PORT_ID 값입니다.
[in] NicIndex
PortId 매개 변수로 지정된 확장 가능한 스위치 포트에 연결된 네트워크 어댑터의 인덱스를 지정하는 NDIS_SWITCH_NIC_INDEX 값입니다.
NDIS_SWITCH_NIC_INDEX 값에 대한 자세한 내용은 네트워크 어댑터 인덱스 값을 참조하세요.
반환 값
호출이 성공하면 함수는 NDIS_STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ndis.h에 정의된 NDIS_STATUS_Xxx 오류 코드를 반환합니다.
설명
확장 가능한 스위치 확장은 SetNetBufferListSource 함수를 호출하여 패킷의 NET_BUFFER_LIST 구조에서 원본 포트 식별자 및 네트워크 어댑터 인덱스를 설정합니다. 확장은 다음 유형의 패킷에 대해 이 작업을 수행합니다.
-
확장이 송신 또는 수신 작업에 할당한 새 패킷입니다.
참고 확장에서 할당된 패킷에 대해 SetNetBufferListSource 를 호출하기 전에 AllocateNetBufferListForwardingContext를 호출해야 합니다.
- 확장이 필터링 중인 원래 패킷에서 복제한 중복된 패킷입니다. 확장은 NdisAllocateCloneNetBufferList를 호출하여 패킷을 복제합니다.
예를 들어 NDIS_SWITCH_DEFAULT_PORT_ID 원본 포트 식별자가 있는 패킷은 신뢰할 수 있으며 확장 가능한 많은 스위치 포트 정책을 무시합니다. 이러한 정책에는 ACL(액세스 제어 목록) 및 QoS(서비스 품질)가 포함됩니다. 확장에서 패킷에 대한 기본이 아닌 원본 포트를 지정하는 경우 해당 포트에 대한 정책을 패킷에 적용할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | NDIS 6.30 이상에서 지원됩니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | ndis.h(Ndis.h 포함) |
| IRQL | <= DISPATCH_LEVEL |
추가 정보
AllocateNetBufferListForwardingContext