OID_PNP_CAPABILITIES
Identyfikator OID OID_PNP_CAPABILITIES żąda sterownika miniportu w celu zwrócenia możliwości wznawiania karty sieciowej lub żądania pośredniego sterownika w celu zwrócenia możliwości wznawiania sterownika pośredniego. Funkcje wznawiania są formatowane jako struktura NDIS_PNP_CAPABILITIES, która jest zdefiniowana w następujący sposób:
typedef struct _NDIS_PNP_CAPABILITIES {
ULONG Flags;
NDIS_PM_WAKE_UP_CAPABILITIES WakeUpCapabilities;
} NDIS_PNP_CAPABILITIES, *PNDIS_PNP_CAPABILITIES;
Elementy członkowskie tej struktury zawierają następujące informacje:
flagi
NDIS_DEVICE_WAKE_UP_ENABLE
NDIS ustawia tę flagę, jeśli podstawowy sterownik miniportu obsługuje co najmniej jedną funkcję wznawiania. Sterowniki protokołów mogą przetestować tę flagę, aby określić, czy podstawowy sterownik miniportu ma możliwości wznawiania. Sterowniki Miniport nie powinny uzyskiwać dostępu do tej flagi.
WakeUpCapabilities
Struktura NDIS_PM_WAKE_UP_CAPABILITIES określająca możliwości wznawiania karty sieciowej sterownika miniportu. Struktura NDIS_PM_WAKE_UP_CAPABILITIES jest zdefiniowana w następujący sposób:
typedef struct _NDIS_PM_WAKE_UP_CAPABILITIES {
NDIS_DEVICE_POWER_STATE MinMagicPacketWakeUp;
NDIS_DEVICE_POWER_STATE MinPatternWakeUp;
NDIS_DEVICE_POWER_STATE MinLinkChangeWakeUp;
} NDIS_PM_WAKE_UP_CAPABILITIES, *PNDIS_PM_WAKE_UP_CAPABILITIES;
Elementy członkowskie tej struktury zawierają następujące informacje:
MinMagicPacketWakeUp
Określa najniższy stan zasilania urządzenia, z którego karta sieciowa sterownika miniportu może sygnalizować wznawianie po otrzymaniu pakietu magicznego. (Pakiet magiczny to pakiet zawierający 16 ciągłych kopii adresu Ethernet odbieranej karty sieciowej). Stan zasilania urządzenia jest określony jako jedna z następujących wartości NDIS_DEVICE_POWER_STATE:
NdisDeviceStateUnspecified
Karta sieciowa nie obsługuje funkcji magic-packet wake-up.
NdisDeviceStateD0
Karta sieciowa może sygnalizować wznawianie pakietów magic-packet ze stanu zasilania urządzenia D0. Ponieważ D0 jest w pełni zasilany, nie powoduje to wznawiania, ale może być używane jako zdarzenie czasu wykonywania.
NdisDeviceStateD1
Karta sieciowa może sygnalizować wznawianie pakietów magic-packet ze stanów zasilania urządzenia D1 i D0.
NdisDeviceStateD2
Karta sieciowa może sygnalizować wznawianie pakietów magic-packet ze stanów D2, D1 i D0.
NdisDeviceStateD3
Karta sieciowa może sygnalizować wznawianie pakietów magic-packet ze stanów zasilania urządzenia D3, D2, D1 i D0.
MinPatternWakeUp
Określa najniższy stan zasilania urządzenia, z którego karta sieciowa sterownika miniportu może sygnalizować zdarzenie wznawiania po otrzymaniu ramki sieciowej zawierającej wzorzec określony przez sterownik protokołu. Stan zasilania jest określony jako jedna z następujących wartości NDIS_DEVICE_POWER_STATE:
NdisDeviceStateUnspecified
Karta sieciowa nie obsługuje wznawiania dopasowania wzorca.
NdisDeviceStateD0
Karta sieciowa może sygnalizować wznawianie wzorca ze stanu zasilania urządzenia D0. Ponieważ D0 jest w pełni zasilany, nie powoduje to wznawiania, ale może być używane jako zdarzenie czasu wykonywania.
NdisDeviceStateD1
Karta sieciowa może sygnalizować wznawianie wzorca ze stanów zasilania urządzenia D1 i D0.
NdisDeviceStateD2
Karta sieciowa może sygnalizować wznawianie wzorca ze stanów zasilania urządzenia D2, D1 i D0.
NdisDeviceStateD3
Karta sieciowa może sygnalizować wznawianie wzorca ze stanów zasilania urządzenia D3, D2, D1 i D0.
MinLinkChangeWakeUp
Zastrzeżony. NDIS ignoruje ten element członkowski.
dla sterowników miniportu
Po zakończeniu inicjowania sterownika miniportu zarówno sterownik protokołu, jak i NDIS mogą wysyłać zapytania do sterownika miniportu za pomocą tego identyfikatora OID, aby określić następujące elementy:
Czy sterownik miniportu jest świadomy PM.
Możliwości karty sieciowej wskazujące zdarzenia wznawiania sieci.
Jeśli sterownik miniportu zwróci NDIS_STATUS_SUCCESS do zapytania OID_PNP_CAPABILITIES, NDIS uważa, że sterownik miniportu ma być świadomy pm. Jeśli sterownik miniportu zwróci NDIS_STATUS_NOT_SUPPORTED, NDIS uzna sterownik miniportu za starszy sterownik miniportu, który nie jest świadomy PM.
Podczas wywoływania NdisMSetAttributesExsterownik miniportu, który nie obsługuje funkcji wznawiania, ale może zapisywać i przywracać stan karty sieciowej w przejściu stanu zasilania może ustawić flagę NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND. Ustawienie tej flagi uniemożliwia usłudze NDIS wywoływanie funkcji MiniportHalt sterownika przed przejściem systemu do stanu uśpienia (w stanie uśpienia). Jeśli jednak sterownik miniportu zwróci NDIS_STATUS_NOT_SUPPORTED w odpowiedzi na zapytanie OID_PNP_CAPABILITIES, usługa NDIS ignoruje flagę NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND i zatrzymuje kartę sieciową, jeśli system przejdzie w stan niskiego zużycia energii.
Karta sieciowa sterownika miniportu może obsługiwać dowolną kombinację zdarzeń wznawiania, w tym bez zdarzeń wznawiania. Sterownik miniportu może nadal obsługiwać zarządzanie energią, nawet jeśli karta sieciowa nie może sygnalizować zdarzeń wznawiania. W tym przypadku jedynymi identyfikatorami OID zarządzania energią obsługiwanymi przez sterownik miniportu oprócz OID_PNP_CAPABILITIES są OID_PNP_QUERY_POWER i OID_PNP_SET_POWER.
Jeśli karta sieciowa sterownika miniportu nie obsługuje określonego zdarzenia wznawiania, sterownik miniportu powinien wskazywać wartość NDIS_DEVICE_POWER_STATENdisDeviceStateUnspecified dla zdarzenia wznawiania w strukturze NDIS_PM_WAKE_UP_CAPABILITIES.
OID_PNP_CAPABILITIES wskazuje tylko możliwości wznawiania karty sieciowej sterownika miniportu; nie włącza takich możliwości. OID_PNP_ENABLE_WAKE_UP służy do włączania funkcji wznawiania karty sieciowej.
dla sterowników pośrednich
Jeśli podstawowa karta sieciowa jest świadoma pm, sterownik pośredni powinien zwrócić NDIS_STATUS_SUCCESS do zapytania OID_PNP_CAPABILITIES. W strukturze NDIS_PM_WAKE_UP_CAPABILITIES zwróconej przez ten identyfikator OID sterownik pośredni powinien określić stan zasilania urządzenia NdisDeviceStateUnspecified dla każdej funkcji wznawiania (MinMagicPacketWakeUp lub MinPatternWakeUp). Taka odpowiedź wskazuje, że sterownik pośredni jest świadomy pm,ale nie zarządza urządzeniem fizycznym.
Jeśli podstawowa karta sieciowa nie jest świadoma pm, sterownik pośredni powinien zwrócić NDIS_STATUS_NOT_SUPPORTED do zapytania OID_PNP_CAPABILITIES.
Uwaga Aby uzyskać informacje o tym, jak sterowniki NDIS 6.20 i nowszych miniportów raportują możliwości zarządzania energią, zobacz Funkcje zarządzania energią raportowania.
Wymagania
Wersja |
Obsługiwane w usługach NDIS 6.0 i NDIS 6.1. W przypadku usługi NDIS 6.20 lub nowszej należy użyć OID_PM_CURRENT_CAPABILITIES. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |