다음을 통해 공유


OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES

오버리싱 드라이버는 네트워크 어댑터의 수신 필터링 하드웨어 기능을 얻기 위해 OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES OID 쿼리 요청을 실행합니다.

OID 쿼리 요청에서 성공적으로 반환된 후 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버는NDIS_RECEIVE_FILTER_CAPABILITIES 구조체에 대한 포인터를 포함합니다.

설명

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

NDIS_RECEIVE_FILTER_CAPABILITIES 구조에는 네트워크 어댑터의 수신 필터링 하드웨어 기능에 대한 정보가 포함되어 있습니다. 이러한 기능에는 현재 INF 파일 설정 또는 고급 속성 페이지를 통해 사용하지 않도록 설정된 하드웨어 기능이 포함될 수 있습니다.

참고 네트워크 어댑터의 모든 수신 필터링 하드웨어 기능은 기능 사용 여부에 관계없이 OID_RECEIVE_FILTER_HARDWARE_CAPABILITIES OID 쿼리 요청을 통해 반환됩니다.

NDIS 6.20부터 미니포트 드라이버는 MiniportInitializeEx 함수가 호출될 때 네트워크 어댑터의 현재 활성화된 수신 필터링 하드웨어 기능을 등록합니다. 미니포트 드라이버는 다음 단계에 따라 이러한 기능을 등록합니다.

  1. 드라이버는 수신 필터링 하드웨어 기능을 사용하여 NDIS_RECEIVE_FILTER_CAPABILITIES 구조를 초기화합니다.

  2. 드라이버는 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조를 초기화하고 CurrentReceiveFilterCapabilities 멤버를 NDIS_RECEIVE_FILTER_CAPABILITIES 구조체에 대한 포인터로 설정합니다.

  3. 미니포트 드라이버는 NdisMSetMiniportAttributes 함수를 호출하고 MiniportAttributes 매개 변수를 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조체에 대한 포인터로 설정합니다.

상태 코드 반환

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

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

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

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

NDIS_STATUS_NOT_SUPPORTED
네트워크 어댑터는 수신 필터링을 지원하지 않습니다.

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

요구 사항

Version

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

헤더

Ntddndis.h(Ndis.h 포함)

추가 정보

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CAPABILITIES