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_RECEIVE_FILTER_PARAMETERS 구조체입니다.

• 네트워크 패킷 헤더의 필드에 대한 필터 테스트 조건을 지정하는 NDIS_RECEIVE_FILTER_FIELD_PARAMETERS 구조체의 배열입니다.

설명

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

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

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

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

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

오버리싱 드라이버는 OID_RECEIVE_FILTER_SET_FILTER 이전 OID 메서드 요청 또는 OID_RECEIVE_FILTER_ENUM_FILTERS OID 요청에서 필터 식별자를 얻었습니다.

상태 코드 반환

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

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

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

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

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

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

요구 사항

Version	NDIS 6.20 이상에서 지원됩니다.
헤더	Ntddndis.h(Ndis.h 포함)

추가 정보

NDIS_OID_REQUEST

OID_RECEIVE_FILTER_ENUM_FILTERS

NDIS_RECEIVE_FILTER_PARAMETERS

OID_RECEIVE_FILTER_SET_FILTER