OID_RECEIVE_FILTER_CURRENT_CAPABILITIES

오버리싱 드라이버는 네트워크 어댑터의 현재 사용 가능한 수신 필터링 기능을 얻기 위해 OID_RECEIVE_FILTER_CURRENT_CAPABILITIES OID 쿼리 요청을 실행합니다.

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

설명

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

NDIS 패킷 병합. 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 패킷 병합 수신 필터 관리를 참조하세요.
SR-IOV(단일 루트 I/O 가상화). 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 가상 포트에서 수신 필터 설정을 참조하세요.
VMQ(Virtual Machine Queue). 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 VMQ 필터 설정 및 지우기를 참조하세요.

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

드라이버는 현재 활성화된 수신 필터링 하드웨어 기능을 사용하여 NDIS_RECEIVE_FILTER_CAPABILITIES 구조를 초기화합니다.
드라이버는 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조를 초기화하고 CurrentReceiveFilterCapabilities 멤버를 NDIS_RECEIVE_FILTER_CAPABILITIES 구조체에 대한 포인터로 설정합니다.
미니포트 드라이버는 NdisMSetMiniportAttributes 함수를 호출하고 MiniportAttributes 매개 변수를 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조체에 대한 포인터로 설정합니다.

프로토콜 및 필터 드라이버를 과도하게 사용하는 경우 OID_RECEIVE_FILTER_CURRENT_CAPABILITIES OID 쿼리 요청을 실행할 필요가 없습니다. NDIS는 다음과 같은 방법으로 이러한 드라이버에 현재 활성화된 수신 필터링 기능을 제공합니다.

NDIS는 바인딩 작업 중 NDIS_BIND_PARAMETERS 구조체의 ReceiveFilterCapabilities 멤버에 있는 프로토콜 드라이버에 대한 기본 네트워크 어댑터의 현재 활성화된 수신 필터링 기능을 제공합니다.
NDIS는 연결 작업 중에 NDIS_FILTER_ATTACH_PARAMETERS 구조체의 ReceiveFilterCapabilities 멤버에 있는 필터 드라이버에 대한 기본 네트워크 어댑터의 현재 활성화된 수신 필터링 기능을 제공합니다.

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

NDIS_STATUS_SUCCESS
요청이 성공적으로 완료되었습니다. InformationBuffer는 NDIS_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 포함)