OID_PM_CURRENT_CAPABILITIES

Jako zapytanie, nadmierne sterowniki mogą używać OID_PM_CURRENT_CAPABILITIES OID do wykonywania zapytań dotyczących obecnie dostępnych możliwości zarządzania energią karty sieciowej. Po pomyślnym powrocie z żądania zapytania OID InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_PM_CAPABILITIES.

Uwagi

Usługa NDIS obsługuje zapytanie dotyczące sterowników miniportu. Począwszy od NDIS 6.20, sterowniki miniportu zapewniają możliwości sprzętu zarządzania energią podczas inicjowania. Jednak usługa NDIS może ukryć niektóre możliwości sterownika protokołu. Na przykład usługa NDIS może zgłaszać różne możliwości, gdy użytkownik wyłączy niektóre lub wszystkie możliwości zarządzania energią.

Należy pamiętać, że bieżące możliwości zarządzania energią, które NDIS zgłaszają do sterownika protokołu, nie muszą być takie same jak możliwości sprzętowe, które sterownik miniportu zgłosił do usługi NDIS.

Usługa NDIS zgłasza możliwości zarządzania energią bazowej karty sieciowej do nadmiernych sterowników protokołów w PowerManagementCapabilitiesEx elementu członkowskiego struktury NDIS_BIND_PARAMETERS podczas operacji powiązania. W związku z tym sterowniki protokołów nie muszą wykonywać zapytań dotyczących OID.

Usługa NDIS wystawia NDIS_STATUS_PM_CAPABILITIES_CHANGE wskazanie stanu w celu zgłaszania zmian w funkcjach zarządzania energią, które są dostępne dla nadmiernych sterowników.

Jeśli podstawowa karta sieciowa ma sterownik NDIS 6.1 lub starszy miniport, usługa NDIS tłumaczy możliwości zarządzania energią podstawowej karty sieciowej na strukturę NDIS_PM_CAPABILITIES.

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 wskazuje strukturę NDIS_PM_CAPABILITIES.

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_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)

Zobacz też

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE