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.
Nadmierne sterowniki wydają żądania zestawów identyfikatorów OID OID_RECEIVE_FILTER_CLEAR_FILTER w celu wyczyszczenia filtru odbierania na karcie sieciowej.
Element InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS.
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.
Żądanie zestawu identyfikatorów OID OID_RECEIVE_FILTER_CLEAR_FILTER jest obowiązkowe dla sterowników miniportu, które obsługują łączenie pakietów NDIS, SR-IOV lub interfejs VMQ.
Sterownik overlying, taki jak protokół NDIS lub sterownik filtru, używa OID_RECEIVE_FILTER_CLEAR_FILTER ustawionego żądania w celu wyczyszczenia wcześniej ustawionego filtru. Tylko sterownik, który ustawił filtr odbierania, może go wyczyścić.
Nadmierny sterownik czyści filtr odbierania, ustawiając element FilterId elementu członkowskiego struktury NDIS_RECEIVE_FILTER_CLEAR_PARAMETERS na identyfikator filtru. Sterownik uzyskał identyfikator filtru z wcześniejszego żądania metody OID OID_RECEIVE_FILTER_SET_FILTER.
Dodatkowe instrukcje dotyczące łączenia pakietów NDIS
Następujący punkt dotyczy sterowników miniportu i nadmiernie obsługujących łączenie pakietów NDIS:
- Nadmierny sterownik musi wyczyścić wszystkie filtry odbierania ustawione na sterowniku miniportu przed odłączanie lub odłączanie od sterownika.
Dodatkowe wytyczne dotyczące interfejsu SR-IOV
Następujące kwestie dotyczą sterowników miniportu i nadmiernie obsługujących interfejs SR-IOV:
Sterownik overlying musi wyczyścić wszystkie filtry ustawione na SR-IOV VPort, zanim zwolni VPort. Sterownik overlying musi również wyczyścić wszystkie filtry ustawione na domyślnym VPort przed zamknięciem powiązania z kartą sieciową.
Sterownik miniportu nie może wskazywać pakietów na niedefault VPort, jeśli zakończył żądanie OID OID_RECEIVE_FILTER_CLEAR_FILTER w celu wyczyszczenia ostatniego filtru w VPort.
Uwaga sterownik miniportu również nie może wskazywać pakietów na niedefault VPort, jeśli zakończył żądanie OID OID_NIC_SWITCH_DELETE_VPORT, aby zwolnić VPort.
Dodatkowe wytyczne dotyczące interfejsu VMQ
Następujące kwestie dotyczą sterowników miniportowania i nadmiernego obsługi interfejsu VMQ:
Nadmierny sterownik musi wyczyścić wszystkie filtry ustawione w kolejce odbierania vmQ, zanim zwolni kolejkę. Sterownik overlying musi również wyczyścić wszystkie filtry ustawione w domyślnych lub upuszczanych kolejkach przed zamknięciem powiązania z kartą sieciową.
Sterownik miniportu nie może wskazywać pakietów w kolejce odbierania, jeśli ukończono żądanie OID OID_RECEIVE_FILTER_CLEAR_FILTER w celu wyczyszczenia ostatniego filtru w kolejce odbierania.
Uwaga sterownik miniportu nie może również wskazywać pakietów w kolejce odbierania, jeśli zakończył żądanie OID OID_RECEIVE_FILTER_FREE_QUEUE, aby zwolnić kolejkę odbierania.
Kody stanu powrotu
Funkcjaminiportu sterownikaMiniportOidRequest zwraca jedną z następujących wartości dla tego żądania:
| Termin | Opis |
|---|---|
NDIS_STATUS_SUCCESS |
Sterownik miniportu zakończył żądanie pomyślnie. |
NDIS_STATUS_PENDING |
Sterownik miniportu zakończy żądanie asynchronicznie. Po zakończeniu całego przetwarzania przez sterownik miniportu żądanie musi zakończyć się powodzeniem przez wywołanie funkcji NdisMOidRequestComplete, przekazując NDIS_STATUS_SUCCESS dla parametru stanu. |
NDIS_STATUS_NOT_ACCEPTED |
Karta miniport została usunięta. |
Usługa NDIS zwraca jeden z następujących kodów stanu dla tego żądania:
NDIS_STATUS_SUCCESS
Określony filtr został pomyślnie wyczyszczone.
NDIS_STATUS_PENDING
Żądanie oczekuje na ukończenie. Usługa NDIS przekaże końcowy kod stanu i wyniki do procedury obsługi ukończenia żądania OID obiektu wywołującego po zakończeniu żądania.
NDIS_STATUS_FILE_NOT_FOUND
Identyfikator filtru jest nieprawidłowy.
NDIS_STATUS_INVALID_LENGTH
Bufor informacyjny jest za mały. Usługa NDIS ustawia DATA. SET_INFORMATION. BajtyNowe składowe w strukturze NDIS_OID_REQUEST do minimalnego wymaganego rozmiaru buforu.
Wymagania
Wersja |
Obsługiwane w usłudze NDIS 6.20 lub nowszym. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |