Condividi tramite

Funzionalità di sospensione selettiva NDIS

  • Articolo

A partire da NDIS 6.30, i driver miniport devono segnalare se il driver ha abilitato il supporto per la sospensione selettiva di NDIS. Il supporto per la sospensione selettiva NDIS è abilitato oppure disabilitato tramite l'impostazione del termine chiave INF standardizzato *SelectiveSuspend. Per ulteriori informazioni su questa parola chiave INF, vedere Parole Chiave INF Standardizzate per NDIS Selective Suspend.

Quando NDIS chiama la funzione MiniportInitializeEx del driver, il driver miniport segnala il supporto per la sospensione selettiva NDIS seguendo questa procedura:

  1. Il driver inizializza una struttura NDIS_PM_CAPABILITIES con le funzionalità di risparmio energia dell'hardware sottostante.

    Se il driver abilita il supporto per la sospensione selettiva NDIS, deve impostare i membri della struttura NDIS_PM_CAPABILITIES come indicato di seguito:

    • Il driver miniport deve specificare NDIS_PM_CAPABILITIES_REVISION_2 e NDIS_SIZEOF_NDIS_PM_CAPABILITIES_REVISION_2 per la revisione e la lunghezza della struttura NDIS_PM_CAPABILITIES all'interno del membro Header della struttura.
    • Se la parola chiave *SelectiveSuspend ha un valore pari a uno, il supporto del driver miniport per la sospensione selettiva NDIS è abilitato. Il driver miniport segnala questo impostando il flag NDIS_PM_SELECTIVE_SUSPEND_SUPPORTED all'interno del membro Flags di questa struttura.

  2. Dopo aver inizializzato la struttura di NDIS_PM_CAPABILITIES, il driver miniport imposta il membro PowerManagementCapabilitiesEx della struttura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES in modo che punti alla struttura NDIS_PM_CAPABILITIES inizializzata. Il driver miniport passa un puntatore a una struttura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES nel parametro MiniportAttributes quando chiama la funzione NdisMSetMiniportAttributes.

Il metodo usato dai driver miniport per segnalare lo stato di supporto della sospensione selettiva NDIS si basa sul metodo NDIS 6.20 per la creazione di report sulle funzionalità di risparmio energia. Per altre informazioni su questo metodo, vedere Reporting Power Management Capabilities.

Per altre informazioni sul processo di inizializzazione dell'adattatore, vedere Inizializzazione di un adattatore Miniport.