OID_PM_ADD_WOL_PATTERN
Jako zestaw sterowniki protokołów NDIS używają OID_PM_ADD_WOL_PATTERN OID, aby dodać wzorzec zarządzania energią wake-on-LAN do karty sieciowej. Element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_PM_WOL_PATTERN.
Uwagi
Sterowniki protokołów NDIS 6.20 i nowszych używają OID_PM_ADD_WOL_PATTERN do dodawania wzorca Wake on LAN (WOL) do karty sieciowej. Żądanie identyfikatora OID zawiera kryterium, które karta sieciowa musi porównać z pakietami przychodzącymi, gdy jest w stanie niskiego zasilania. Karta sieciowa musi wygenerować zdarzenie wznawiania, gdy odbiera pakiet zgodny z kryteriami wzorca.
Sterownik protokołu może dodać wzorce WOL po pomyślnym powiązaniu z podstawową kartą sieciową i natychmiast po utworzeniu niezbędnych danych (takich jak adres IP interfejsu) w celu skonfigurowania wzorca WOL. Sterownik protokołu może również dodać wzorzec WOL w odpowiedzi na inne powiadomienia o zdarzeniach zarządzania energią, takie jak odrzucenie wcześniej dodanego wzorca WOL lub odciążony protokół.
Aby uniknąć warunków wyścigu w sieci NDIS i innych sterowników protokołów, które są powiązane z tą samą kartą miniportu, po rozpoczęciu konfiguracji sieciowej karty sieciowej do stanu niskiego zasilania, próba dodania nowego wzorca wznawiania do tej karty sieciowej zakończy się niepowodzeniem. Jeśli na przykład sterownik protokołu NDIS próbuje dodać nowy wzorzec WOL w kontekście przetwarzania NetEventSetPower powiadomienia o zdarzeniu dla tej karty sieciowej, usługa NDIS zakończy się niepowodzeniem żądania.
Zanim usługa NDIS wyśle to żądanie identyfikatora OID do źródłowych sterowników NDIS lub ukończy żądanie do nadmiernego sterownika, ustawia składową struktury NDIS_PM_WOL_PATTERN ULONG PatternId na unikatową wartość. Sterowniki protokołów i NDIS używają tego identyfikatora wzorca z żądaniem OID_PM_REMOVE_WOL_PATTERN OID, aby usunąć wzorzec WOL z podstawowej karty sieciowej.
Uwaga Identyfikator wzorca jest unikatową wartością dla każdego z wzorców ustawionych na karcie sieciowej. Jednak identyfikator wzorca nie jest globalnie unikatowy dla wszystkich kart miniportowych.
Jeśli NDIS lub podstawowa karta sieciowa usunie wzorzec WOL, generuje NDIS_STATUS_PM_WOL_PATTERN_REJECTED wskazania stanu. Element StatusBuffer składowej struktury NDIS_STATUS_INDICATION zawiera identyfikator wzorca ULONG WOL odrzuconego wzorca WOL.
Sterownik miniportu zwraca jeden z następujących kodów stanu dla żądania:
NDIS_STATUS_SUCCESS
Żądany wzorzec został pomyślnie dodany. Element PatternId struktury NDIS_PM_WOL_PATTERN zawiera identyfikator wzorca.
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_PM_WOL_PATTERN_LIST_FULL
Żądanie nie powiodło się, ponieważ lista wzorców jest pełna, a karta sieciowa nie może dodać innego wzorca.
NDIS_STATUS_RESOURCES
NDIS lub podstawowa karta sieciowa nie mogła dodać nowego wzorca ze względu na brak zasobów.
NDIS_STATUS_INVALID_PARAMETER
Co najmniej jeden parametr w strukturze NDIS_PM_WOL_PATTERN był nieprawidłowy.
NDIS_STATUS_BUFFER_TOO_SHORT
Bufor informacyjny był zbyt krótki. NDIS ustaw DATA. SET_INFORMATION. BajtyNowe składowe w strukturze NDIS_OID_REQUEST do minimalnego wymaganego rozmiaru buforu.
NDIS_STATUS_NOT_SUPPORTED
Karta sieciowa nie obsługuje żądanego wzorca WOL.
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. Obowiązkowe dla sterowników miniportu. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |