OID_PM_CURRENT_CAPABILITIES
Come query, i driver overlying possono usare l'OID OID_PM_CURRENT_CAPABILITIES per eseguire query sulle funzionalità di risparmio energia attualmente disponibili di una scheda di rete. Dopo aver restituito correttamente la richiesta di query OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_PM_CAPABILITIES .
Commenti
NDIS gestisce la query per i driver miniport. A partire da NDIS 6.20, i driver miniport forniscono le funzionalità hardware di risparmio energia durante l'inizializzazione. Tuttavia, NDIS può nascondere alcune funzionalità dal driver del protocollo. Ad esempio, NDIS potrebbe segnalare funzionalità diverse quando un utente disabilita alcune o tutte le funzionalità di risparmio energia.
Si noti che le funzionalità di risparmio energia correnti che NDIS segnala a un driver di protocollo non sono necessariamente uguali alle funzionalità hardware che il driver miniport ha segnalato a NDIS.
NDIS segnala le funzionalità di risparmio energia di una scheda di rete sottostante per eseguire l'overlying dei driver di protocollo nel membro PowerManagementCapabilitiesEx della struttura di NDIS_BIND_PARAMETERS durante l'operazione di associazione. Pertanto, i driver del protocollo non devono eseguire query sull'OID.
NDIS genera un'indicazione di stato NDIS_STATUS_PM_CAPABILITIES_CHANGE per segnalare le modifiche apportate alle funzionalità di risparmio energia disponibili per i driver overlying.
Se la scheda di rete sottostante ha un driver miniport NDIS 6.1 o versione precedente, NDIS converte le funzionalità di risparmio energia della scheda di rete sottostante in una struttura NDIS_PM_CAPABILITIES .
NDIS restituisce uno dei codici di stato seguenti per la richiesta:
NDIS_STATUS_SUCCESS
La richiesta è stata completata correttamente. InformationBuffer punta a una struttura NDIS_PM_CAPABILITIES.
NDIS_STATUS_PENDING
La richiesta è in sospeso. NDIS passerà il codice di stato finale e i risultati al gestore di completamento della richiesta OID del chiamante dopo il completamento della richiesta.
NDIS_STATUS_BUFFER_TOO_SHORT
Il buffer delle informazioni era troppo breve. NDIS imposta i DATI. QUERY_INFORMATION. Membro ByteNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.
NDIS_STATUS_FAILURE
La richiesta non è riuscita per motivi diversi dai motivi precedenti.
Requisiti
Versione |
Supportato in NDIS 6.20 e versioni successive. Non richiesto per i driver miniport. Vedere la sezione Note. |
Intestazione |
Ntddndis.h (include Ndis.h) |