OID_PM_PROTOCOL_OFFLOAD_LIST
W ramach zapytania nadmierne sterowniki mogą używać identyfikatora OID OID_PM_PROTOCOL_OFFLOAD_LIST do wyliczania odciążeń protokołu ustawionych na podstawowej karcie sieciowej. Po pomyślnym powrocie z żądania zapytania OID element InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do listy struktur NDIS_PM_PROTOCOL_OFFLOAD opisujących obecnie aktywne odciążenia protokołu.
Uwagi
Usługa NDIS obsługuje zapytanie dotyczące sterowników miniportu. Sterowniki NDIS mogą używać identyfikatora OID OID_PM_PROTOCOL_OFFLOAD_LIST, aby uzyskać listę odciążeń protokołu ustawionych na podstawowej karcie sieciowej.
Dla każdej struktury NDIS_PM_PROTOCOL_OFFLOAD na liście NDIS ustawia NextProtocolOffloadOffset element członkowski od początku buforu informacji OID (czyli początku buforu informacji InformationBuffer elementu członkowskiego struktury NDIS_OID_REQUEST do początku następnej struktury NDIS_PM_PROTOCOL_OFFLOAD na liście. Przesunięcie w NextProtocolOffloadOffset składowej ostatniej struktury na liście wynosi zero.
Jeśli nie ma żadnych odciążeń protokołu ustawionych na karcie sieciowej, usługa NDIS ustawia DATA. QUERY_INFORMATION. BytesWritten składowa struktury NDIS_OID_REQUEST do zera i zwraca NDIS_STATUS_SUCCESS. Dane w DATA. QUERY_INFORMATION. Element członkowski informationBuffer nie jest modyfikowany przez usługę NDIS.
Usługa NDIS zwraca jeden z następujących kodów stanu dla żądania:
NDIS_STATUS_SUCCESS
Żądanie zostało ukończone pomyślnie.
InformationBuffer zawiera wskaźnik do listy odciążeń protokołu, jeśli istnieje.
NDIS_STATUS_PENDING
Żądanie oczekuje na ukończenie. Końcowy kod stanu i wyniki zostaną przekazane do procedury obsługi uzupełniania żądań OID obiektu wywołującego.
NDIS_STATUS_BUFFER_TOO_SHORT
Bufor informacyjny był zbyt krótki. NDIS ustaw 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 powodów innych niż poprzednie.
Wymagania
Wersja |
Obsługiwane w usłudze NDIS 6.20 lub nowszym. Nie zażądano sterowników miniportu. (Zobacz sekcję Uwagi). |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |