OID_PM_PARAMETERS
Come query, i driver di protocollo possono usare l'OID OID_PM_PARAMETERS per eseguire query sulle funzionalità hardware di risparmio energia di una scheda di rete attualmente abilitata. 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_PARAMETERS .
Come set, i driver di protocollo possono usare l'OID OID_PM_PARAMETERS per abilitare o disabilitare le funzionalità hardware correnti di una scheda di rete. Il driver di protocollo fornisce un puntatore a una struttura NDIS_PM_PARAMETERS nel membro InformationBuffer della struttura NDIS_OID_REQUEST .
Commenti
A partire da NDIS 6.20, i driver di protocollo e filtro usano OID_PM_PARAMETERS per eseguire query e impostare le funzionalità hardware di risparmio energia di una scheda di rete attualmente abilitata.
Quando un driver overlying esegue una query sull'OID OID_PM_PARAMETERS, NDIS completa la richiesta senza inoltrarla al driver miniport. NDIS archivia le impostazioni richieste e le combina con le impostazioni di altre richieste di questo tipo. Prima che NDIS passi la scheda di rete allo stato a basso consumo, NDIS invia una richiesta set al driver miniport che contiene le impostazioni combinate da tutte le richieste archiviate da NDIS.
Le funzionalità attualmente abilitate possono essere un subset delle funzionalità supportate dall'hardware. Per altre informazioni sulle funzionalità supportate dall'hardware, vedere OID_PM_HARDWARE_CAPABILITIES.
Nota Se NDIS imposta il flag NDIS_PM_SELECTIVE_SUSPEND_ENABLED nel membro WakeUpFlags della struttura NDIS_PM_PARAMETERS , invia la richiesta del set OID di OID_PM_PARAMETERS direttamente al driver miniport. In questo modo NDIS può ignorare l'elaborazione filtrando i driver nello stack di driver di rete.
NDIS o il driver miniport restituisce uno dei codici di stato seguenti per la richiesta:
NDIS_STATUS_SUCCESS
La richiesta è stata completata correttamente.
NDIS_STATUS_PENDING
La richiesta è in attesa di completamento. NDIS passerà il codice di stato finale e i risultati al gestore di completamento della richiesta OID del chiamante al termine della richiesta.
NDIS_STATUS_BUFFER_TOO_SHORT
Il buffer delle informazioni era troppo breve. NDIS imposta i DATI. QUERY_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.
NDIS_STATUS_INVALID_PARAMETER
La richiesta non è riuscita perché ha tentato di abilitare una funzionalità non supportata dalla scheda di rete sottostante.
NDIS_STATUS_FAILURE
La richiesta non è riuscita per motivi diversi dai motivi precedenti.
Requisiti
Versione |
Supportato in NDIS 6.20 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |