OID_RECEIVE_FILTER_PARAMETERS
Nadmierny sterownik wystawia żądanie metody OID OID_RECEIVE_FILTER_PARAMETERS w celu uzyskania bieżących parametrów konfiguracji filtru na karcie sieciowej.
Element InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_RECEIVE_FILTER_PARAMETERS. Usługa NDIS używa elementu członkowskiego filterId w strukturze danych wejściowych w celu zidentyfikowania filtru.
Po pomyślnym powrocie z żądania metody OID InformationBuffer składowej struktury NDIS_OID_REQUEST zawiera wskaźnik do buforu. Ten bufor jest sformatowany tak, aby zawierał następujące elementy:
Struktura NDIS_RECEIVE_FILTER_PARAMETERS określająca parametry filtru odbierania NDIS.
Tablica struktur NDIS_RECEIVE_FILTER_FIELD_PARAMETERS, która określa kryterium testu filtru dla pola w nagłówku pakietu sieciowego.
Uwagi
Filtry odbierania NDIS są używane w następujących interfejsach NDIS:
pakiet NDIS łączący. Aby uzyskać więcej informacji na temat używania filtrów odbierania w tym interfejsie, zobacz Zarządzanie łączeniem pakietów filtrów odbierania.
wirtualizacji we/wy pojedynczego katalogu głównego (SR-IOV). Aby uzyskać więcej informacji na temat używania filtrów odbierania w tym interfejsie, zobacz Ustawianie filtru odbierania na porcie wirtualnym.
kolejki maszyn wirtualnych (VMQ). Aby uzyskać więcej informacji o sposobie używania filtrów odbierania w tym interfejsie, zobacz Setting and Clearing VMQ Filters.
Nadmierne sterowniki wystawiają żądania metody OID OID_RECEIVE_FILTER_PARAMETERS w celu uzyskania parametrów konfiguracji filtru odbierania ustawionego na karcie sieciowej. Obejmuje to filtr odbierania, który został ustawiony w kolejce odbierania vmQ lub SR-IOV port wirtualny (VPort), a także filtr łączenia pakietów, który został pobrany do sterownika miniportu.
Nadmierny sterownik uzyskał identyfikator filtru z wcześniejszego żądania metody OID OID_RECEIVE_FILTER_SET_FILTER lub żądań identyfikatora OID OID_RECEIVE_FILTER_ENUM_FILTERS.
Kody stanu powrotu
Usługa NDIS obsługuje żądanie OID OID_RECEIVE_FILTER_PARAMETERS dla sterowników miniportu i zwraca jeden z następujących kodów stanu:
NDIS_STATUS_SUCCESS
Żądanie zostało ukończone pomyślnie.
InformationBuffer wskazuje strukturę NDIS_RECEIVE_FILTER_PARAMETERS.
NDIS_STATUS_PENDING
Żądanie oczekuje na ukończenie. Usługa NDIS przekazuje końcowy kod stanu i wyniki do procedury obsługi uzupełniania żądań OID obiektu wywołującego po zakończeniu żądania.
NDIS_STATUS_INVALID_PARAMETER
Nadmierny sterownik lub aplikacja dostarczyła nieprawidłowy identyfikator filtru. Identyfikator filtru jest nieprawidłowy, jeśli ma wartość zero lub jeśli określa niezdefiniowany filtr.
NDIS_STATUS_INVALID_LENGTH
Bufor informacyjny był zbyt krótki. Usługa NDIS ustawia DATA. QUERY_INFORMATION. BajtyNowe składowe w strukturze NDIS_OID_REQUEST do minimalnego wymaganego rozmiaru buforu.
NDIS_STATUS_FAILURE
Żądanie nie powiodło się z innych powodów.
Wymagania
Wersja |
Obsługiwane w usłudze NDIS 6.20 lub nowszym. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |
Zobacz też
OID_RECEIVE_FILTER_ENUM_FILTERS