OID_OFFLOAD_ENCAPSULATION

Jako żądanie zapytania sterowniki nadmiernie używają identyfikatora OID OID_OFFLOAD_ENCAPSULATION w celu uzyskania bieżących ustawień hermetyzacji zadania bazowego adaptera miniportu. Funkcja NDIS obsługuje to zapytanie OID dla sterowników miniportów.

W ramach ustawionego żądania sterowniki nadmiernie używają identyfikatora OID OID_OFFLOAD_ENCAPSULATION, aby ustawić ustawienia hermetyzacji zadania bazowego adaptera miniportu. Sterowniki Miniport, które obsługują odciążanie zadań, muszą obsługiwać to żądanie zestawu identyfikatorów OID.

Uwagi

Element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera strukturę NDIS_OFFLOAD_ENCAPSULATION.

Sterowniki miniportu

Jeśli sterownik miniportu nie obsługuje odciążania i ten identyfikator OID, sterownik powinien zwrócić NDIS_STATUS_NOT_SUPPORTED.

Sterowniki miniportu muszą używać zawartości struktury NDIS_OFFLOAD_ENCAPSULATION, aby zaktualizować obecnie zgłaszane możliwości odciążania PROTOKOŁU TCP. Po aktualizacji sterownik miniportu musi zgłosić bieżące możliwości odciążania zadania z oznaczeniem stanu NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG. To wskazanie stanu gwarantuje, że wszystkie nadmierne sterowniki protokołu są aktualizowane przy użyciu nowych informacji o funkcjach.

Ten identyfikator OID służy do aktywowania wszystkich skonfigurowanych lub włączonych odciążeń lub dezaktywowania wszystkich odciążeń (innymi słowy, sprzęt zaczyna wykonywać odciążania). Nie zapewnia dokładnej kontroli nad poszczególnymi odciążaniami. Zamiast tego OID_TCP_OFFLOAD_PARAMETERS służy do konfigurowania poszczególnych odciążeń i może je również aktywować. Ogólnie rzecz biorąc, większość odciążeń zadań TCP/IP można skonfigurować i aktywować za pomocą OID_TCP_OFFLOAD_PARAMETERS.

Jednak struktura NDIS_OFFLOAD_ENCAPSULATION tego identyfikatora OID obejmuje również dwa inne typy hermetyzacji, które nie są objęte strukturą NDIS_OFFLOAD_PARAMETERS OID_TCP_OFFLOAD_PARAMETERS: NDIS_ENCAPSULATION_IEEE_802_3 i NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED. Sterowniki miniportu muszą obsługiwać tę różnicę w typach hermetyzacji, które są objęte różnymi identyfikatorami OPERACYJNEGO.

Jeśli ten identyfikator OID jest wystawiany przez sterownik protokołu w celu dezaktywowania wszystkich odciążeń, element członkowski Włączone elementu członkowskiego NDIS_OFFLOAD_ENCAPSULATION zostanie ustawiony na wartość NDIS_OFFLOAD_SET_OFF.

Ustawianie hermetyzacji (sterowniki protokołów)

Sterowniki protokołów ustawiają OID_OFFLOAD_ENCAPSULATION po określeniu wymagań hermetyzacji systemu. Sterownik protokołu może określić możliwości podstawowej karty miniportu ze struktury NDIS_BIND_PARAMETERS lub wysyłając zapytanie OID_TCP_OFFLOAD_CURRENT_CONFIG. Sterownik protokołu musi ustawić typ hermetyzacji obsługiwany przez kartę miniportu w co najmniej jednej usłudze odciążania.

Jeśli sterownik miniportu obsługuje dowolny typ odciążania, który obsługuje żądany typ hermetyzacji, sterownik musi zwrócić NDIS_STATUS_SUCCESS w odpowiedzi na zestaw OID_OFFLOAD_ENCAPSULATION. W przeciwnym razie sterownik miniportu powinien zwrócić NDIS_STATUS_INVALID_PARAMETER.

W przypadku operacji wysyłania sterownik protokołu może wysyłać żądania przy użyciu tylko tych typów odciążania obsługiwanych przez kartę miniportu z wymaganym typem hermetyzacji. W związku z tym, jeśli żądanie zestawu identyfikatorów OID OID_OFFLOAD_ENCAPSULATION zakończy się niepowodzeniem, sterownik protokołu nie może używać żadnych ustawień odciążania w żądaniach wysyłania, które są kierowane do tej karty miniport.

W przypadku operacji odbierania sterownik miniportu nie może uruchamiać usług odciążania sum kontrolnych ani zabezpieczeń protokołu internetowego (IPsec), dopóki nie otrzyma żądania zestawu identyfikatorów OID OID_OFFLOAD_ENCAPSULATION.

Uzyskiwanie bieżących ustawień hermetyzacji (sterowniki protokołu)

Sterownik protokołu może wydać zapytanie OID_OFFLOAD_ENCAPSULATION tylko po ustawieniu identyfikatora OID OID_OFFLOAD_ENCAPSULATION.

Usługa NDIS odpowiada za pomocą struktury NDIS_OFFLOAD_ENCAPSULATION zawierającej bieżące ustawienia hermetyzacji.

Sterowniki protokołu muszą być przygotowane do obsługi dowolnego kodu błędu NDIS_STATUS_Xxx. Jeśli wystąpi awaria, sterownik protokołu nie może podjąć próby wykonania żadnych operacji odciążania, które są kierowane do karty miniport, której dotyczy problem.

Zobacz też

NDIS_BIND_PARAMETERS
NDIS_OFFLOAD_ENCAPSULATION
NDIS_OID_REQUEST
NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG
OID_TCP_OFFLOAD_CURRENT_CONFIG

Wymagania

version: Windows Vista and later Header: Ntddndis.h (include Ndis.h)