OID_PM_WOL_PATTERN_LIST

Artykuł
13.03.2025

W ramach zapytania nadmierne sterowniki mogą używać identyfikatora OID OID_PM_WOL_PATTERN_LIST do wyliczania wzorców wznawiania w sieci LAN ustawionych na podstawowej karcie sieciowej. Po pomyślnym powrocie z zapytania InformationBuffer składowej struktury NDIS_OID_REQUEST zawiera wskaźnik do listy struktur NDIS_PM_WOL_PATTERN opisujących aktualnie dodane wzorce WOL.

Uwagi

Usługa NDIS obsługuje zapytanie dotyczące sterowników miniportu. Sterowniki NDIS mogą używać identyfikatora OID OID_PM_WOL_PATTERN_LIST, aby uzyskać listę wznawiania wzorców sieci LAN ustawionych na podstawowej karcie sieciowej.

Dla każdej struktury NDIS_PM_WOL_PATTERN na liście NDIS ustawia element członkowski NextWoLPatternOffset na przesunięcie od początku buforu informacji o identyfikatorze OID (czyli początek buforu informacji InformationBuffer elementu członkowskiego struktury NDIS_OID_REQUEST do początku następnej struktury NDIS_PM_WOL_PATTERN na liście. Przesunięcie w NextWoLPatternOffset składowej ostatniej struktury na liście wynosi zero.

W przypadku przesunięć w strukturze NDIS_PM_WOL_PATTERN innej niż NextWoLPatternOffset (na przykład NameBufferOffset) usługa NDIS zapewnia przesunięcia względem początku każdej struktury NDIS_PM_WOL_PATTERN.

Jeśli nie ma wzorców WOL 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 dla żądania. 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 wzorców WOL, 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)