다음을 통해 공유


OID_RECEIVE_FILTER_PARAMETERS

지나치게 많은 드라이버는 네트워크 어댑터에서 필터의 현재 구성 매개 변수를 가져오기 위해 OID_RECEIVE_FILTER_PARAMETERS OID 메서드 요청을 실행합니다.

NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버는 NDIS_RECEIVE_FILTER_PARAMETERS 구조체에 대한 포인터를 포함합니다. NDIS는 입력 구조에서 FilterId 멤버를 사용하여 필터를 식별합니다.

OID 메서드 요청에서 성공적으로 반환되면 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에 버퍼에 대한 포인터가 포함됩니다. 이 버퍼는 다음을 포함하도록 형식이 지정됩니다.

발언

NDIS 수신 필터는 다음 NDIS 인터페이스에서 사용됩니다.

  • NDIS 패킷 병합. 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 패킷 병합 수신 필터관리를 참조하세요.

  • 단일 루트 I/O 가상화(SR-IOV) . 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 가상 포트수신 필터 설정을 참조하세요.

  • VMQ(Virtual Machine Queue) . 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 VMQ 필터 설정 및 지우기를 참조하세요.

오버리싱 드라이버는 네트워크 어댑터에 설정된 수신 필터에 대한 구성 매개 변수를 가져오기 위해 OID_RECEIVE_FILTER_PARAMETERS OID 메서드 요청을 실행합니다. 여기에는 VMQ 수신 큐 또는 SR-IOV VPort(가상 포트)에 설정된 수신 필터와 미니포트 드라이버에 다운로드된 패킷 병합 필터가 포함됩니다.

지나치게 많은 드라이버는 OID_RECEIVE_FILTER_SET_FILTER 이전 OID 메서드 요청 또는 OID_RECEIVE_FILTER_ENUM_FILTERSOID 요청에서 필터 식별자를 얻었습니다.

상태 코드 반환

NDIS는 미니포트 드라이버에 대한 OID_RECEIVE_FILTER_PARAMETERS OID 요청을 처리하고 다음 상태 코드 중 하나를 반환합니다.

NDIS_STATUS_SUCCESS
요청이 성공적으로 완료되었습니다. InformationBufferNDIS_RECEIVE_FILTER_PARAMETERS 구조를 가리킵니다.

NDIS_STATUS_PENDING
요청이 완료 보류 중입니다. NDIS는 요청이 완료된 후 최종 상태 코드와 결과를 호출자의 OID 요청 완료 처리기에 전달합니다.

NDIS_STATUS_INVALID_PARAMETER
지나치게 많은 드라이버 또는 애플리케이션이 잘못된 필터 식별자를 제공했습니다. 필터 식별자가 0이거나 정의되지 않은 필터를 지정하는 경우 유효하지 않습니다.

NDIS_STATUS_INVALID_LENGTH
정보 버퍼가 너무 짧습니다. NDIS는 DATA를 설정합니다. QUERY_INFORMATION. NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버를 필요한 최소 버퍼 크기로 설정합니다.

NDIS_STATUS_FAILURE
다른 이유로 인해 요청이 실패했습니다.

요구 사항

버전

NDIS 6.20 이상에서 지원됩니다.

머리글

Ntddndis.h(Ndis.h 포함)

참고 항목

NDIS_OID_REQUEST

OID_RECEIVE_FILTER_ENUM_FILTERS

NDIS_RECEIVE_FILTER_PARAMETERS

OID_RECEIVE_FILTER_SET_FILTER