Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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