OID_PM_PARAMETERS

Jako zapytanie sterowniki protokołów mogą używać identyfikatora OID OID_PM_PARAMETERS do wykonywania zapytań dotyczących możliwości sprzętu zarządzania energią karty sieciowej, która jest obecnie włączona. Po pomyślnym powrocie z żądania zapytania OID InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_PM_PARAMETERS.

Jako zestaw sterowniki protokołów mogą używać identyfikatora OID OID_PM_PARAMETERS do włączania lub wyłączania bieżących możliwości sprzętowych karty sieciowej. Sterownik protokołu zapewnia wskaźnik do struktury NDIS_PM_PARAMETERS w InformationBuffer składowej struktury NDIS_OID_REQUEST.

Uwagi

Począwszy od NDIS 6.20, nadmierne użycie protokołów i sterowników filtrów używa OID_PM_PARAMETERS do wykonywania zapytań i ustawiania możliwości sprzętu zarządzania energią karty sieciowej, która jest obecnie włączona.

Gdy nadmierny sterownik wysyła zapytanie do identyfikatora OID OID_PM_PARAMETERS, usługa NDIS kończy żądanie bez przekazywania go do sterownika miniportu. Usługa NDIS przechowuje żądane ustawienia i łączy je z ustawieniami innych takich żądań. Zanim usługa NDIS przeniesie kartę sieciową do stanu niskiego zasilania, usługa NDIS wysyła ustawione żądanie do sterownika miniportu zawierającego połączone ustawienia ze wszystkich przechowywanych żądań NDIS.

Możliwości, które są obecnie włączone, mogą być podzbiorem możliwości, które obsługuje sprzęt. Aby uzyskać więcej informacji na temat możliwości, które obsługuje sprzęt, zobacz OID_PM_HARDWARE_CAPABILITIES.

Uwaga Jeśli NDIS ustawia flagę NDIS_PM_SELECTIVE_SUSPEND_ENABLED w WakeUpFlags składowej struktury NDIS_PM_PARAMETERS, wystawia żądanie zestawu identyfikatorów OID OID_PM_PARAMETERS bezpośrednio do sterownika miniportu. Dzięki temu usługa NDIS może pominąć przetwarzanie przez sterowniki filtru w stosie sterowników sieciowych.

Sterownik NDIS lub miniport zwraca jeden z następujących kodów stanu dla żądania:

NDIS_STATUS_SUCCESS
Żądanie zostało ukończone pomyślnie.

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_INVALID_PARAMETER
Żądanie nie powiodło się, ponieważ podjęto próbę włączenia możliwości, która nie jest obsługiwana przez podstawową kartę sieciową.

NDIS_STATUS_FAILURE
Żądanie nie powiodło się z powodów innych niż poprzednie.

Wymagania

Zobacz też

NDIS_OID_REQUEST

NDIS_PM_PARAMETERS

OID_PM_HARDWARE_CAPABILITIES