OID_RECEIVE_FILTER_ENUM_FILTERS
오버리싱 드라이버는 네트워크 어댑터에 구성된 모든 필터 목록을 가져오기 위해 OID_RECEIVE_FILTER_ENUM_FILTERS OID 메서드 요청을 발급합니다.
NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버는 NDIS_RECEIVE_FILTER_INFO_ARRAY 구조체에 대한 포인터를 포함합니다.
OID 메서드 요청에서 성공적으로 반환되면 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에 버퍼에 대한 포인터가 포함됩니다. 이 버퍼는 다음을 포함하도록 형식이 지정됩니다.
미니포트 드라이버에 현재 구성된 수신 필터 목록을 지정하는 NDIS_RECEIVE_FILTER_INFO_ARRAY 구조체입니다.
NDIS_RECEIVE_FILTER_INFO 구조체의 배열입니다. 각 구조체는 미니포트 드라이버에 현재 구성된 수신 필터의 매개 변수를 지정합니다.
설명
NDIS 수신 필터는 다음 NDIS 인터페이스에서 사용됩니다.
NDIS 패킷 병합. 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 패킷 병합 수신 필터 관리를 참조하세요.
SR-IOV(단일 루트 I/O 가상화). 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 가상 포트에서 수신 필터 설정을 참조하세요.
VMQ(Virtual Machine Queue). 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 VMQ 필터 설정 및 지우기를 참조하세요.
오버레이 드라이버 또는 애플리케이션은 네트워크 어댑터에 설정된 수신 필터를 열거하기 위해 OID_RECEIVE_FILTER_ENUM_FILTERS OID 메서드 요청을 실행합니다. 여기에는 SR-IOV VPort(가상 포트) 또는 VMQ 수신 큐에 설정된 수신 필터가 포함됩니다.
NDIS 패킷 병합 인터페이스에 대한 추가 지침
Windows Server 2012 NDIS 패킷 병합은 네트워크 어댑터의 기본 수신 큐만 지원합니다.
패킷 병합 수신 필터를 열거하려면 오버레이 드라이버가 NDIS_RECEIVE_FILTER_INFO_ARRAY 구조체의 QueueId 멤버를 NDIS_DEFAULT_RECEIVE_QUEUE_ID 설정해야 합니다.
SR-IOV 인터페이스에 대한 추가 지침
Windows Server 2012 SR-IOV 인터페이스는 VPort(가상 포트)의 기본 수신 큐만 지원합니다.
VPort 수신 필터를 열거하려면 오버레이 드라이버가 NDIS_RECEIVE_FILTER_INFO_ARRAY 구조체의 QueueId 멤버를 NDIS_DEFAULT_RECEIVE_QUEUE_ID 설정해야 합니다.
VMQ 인터페이스에 대한 추가 지침
오버레이팅 드라이버는 OID_RECEIVE_FILTER_ENUM_FILTERS OID 메서드 요청을 실행하여 VMQ 수신 큐에 설정된 수신 필터를 열거할 수 있습니다. 오버리싱 드라이버는 NDIS_RECEIVE_FILTER_INFO_ARRAY 구조를 초기화할 때 QueueId 멤버를 다음 값 중 하나로 설정합니다.
기본이 아닌 수신 큐에 대한 큐 식별자 값입니다. 오버리싱 드라이버는 OID_RECEIVE_FILTER_ALLOCATE_QUEUE 이전 OID 메서드 요청 또는 OID_RECEIVE_FILTER_ENUM_QUEUES OID 쿼리 요청에서 큐 식별자 입력 값을 얻었습니다.
기본 수신 큐를 지정하는 NDIS_DEFAULT_RECEIVE_QUEUE_ID 큐 식별자 값입니다.
상태 코드 반환
NDIS는 미니포트 드라이버에 대한 OID_RECEIVE_FILTER_ENUM_FILTERS OID 메서드 요청을 처리하고 다음 상태 코드 중 하나를 반환합니다.
NDIS_STATUS_SUCCESS
요청이 성공적으로 완료되었습니다. InformationBuffer는 NDIS_RECEIVE_FILTER_INFO_ARRAY 구조를 가리킵니다.
NDIS_STATUS_PENDING
요청이 완료될 때까지 보류 중입니다. NDIS는 요청이 완료된 후 최종 상태 코드와 결과를 호출자의 OID 요청 완료 처리기에 전달합니다.
NDIS_STATUS_INVALID_LENGTH
정보 버퍼가 너무 짧습니다. NDIS는 데이터를 설정합니다 . QUERY_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다.
NDIS_STATUS_FAILURE
다른 이유로 인해 요청이 실패했습니다.
요구 사항
Version |
NDIS 6.20 이상에서 지원됩니다. |
헤더 |
Ntddndis.h(Ndis.h 포함) |
추가 정보
NDIS_RECEIVE_FILTER_INFO_ARRAY
OID_RECEIVE_FILTER_ALLOCATE_QUEUE