Condividi tramite

Funzionalità di sospensione selettiva NDIS per la creazione di report

  • Articolo

A partire da NDIS 6.30, i driver miniport devono segnalare se il driver ha abilitato il supporto per la sospensione selettiva NDIS. Il supporto per la sospensione selettiva NDIS è abilitato o disabilitato tramite l'impostazione della parola chiave INF standardizzata *SelectiveSuspend . Per altre informazioni su questa parola chiave INF, vedere Parole chiave INF standardizzate per la sospensione selettiva NDIS.

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 valore impostando il flag NDIS_PM_SELECTIVE_SUSPEND_SUPPORTED all'interno del membro Flags di questa struttura.

  2. Dopo aver inizializzato la struttura 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 il driver 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 segnalazione delle funzionalità di risparmio energia. Per altre informazioni su questo metodo, vedere Reporting Power Management Capabilities.For more information about this method, see Reporting Power Management Capabilities.

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