Riepilogo delle modifiche necessarie per convertire un driver Miniport in NDIS 6.20

Questo argomento riepiloga le modifiche necessarie per convertire un driver miniport NDIS 6.x in NDIS 6.20.

NDIS 6.20 mantiene la compatibilità con le versioni precedenti di NDIS. Per altre informazioni sulla compatibilità con le versioni precedenti, vedere compatibilità con le versioni precedenti di NDIS 6.20.

Per aggiornare un driver miniport per supportare l'ambiente NDIS 6.20, è necessario modificare il driver miniport NDIS 6.x come indicato di seguito:

ambiente di build
Sostituire la definizione del preprocessore NDIS60_MINIPORT_DRIVER o NDIS61_MINIPORT_DRIVER con NDIS620_MINIPORT_DRIVER.

requisiti generali di conversione

• Sostituire le interfacce obsolete con le versioni NDIS 6.20. Per altre informazioni sulle interfacce obsolete, vedere Interfacce obsolete in NDIS 6.20.

• Aggiornare le interfacce seguenti per supportare più di 64 processori:

  • Ricevere il ridimensionamento laterale (RSS)
  • Interfacce del driver del dispositivo per le informazioni sul processore
  • Allocazione delle risorse
  • Blocchi di lettura e scrittura

  Per altre informazioni sul supporto di più di 64 processori, vedere Supporto per più di 64 processori in NDIS 6.20.

Inizializzazione del driver

• Impostare la versione NDIS su 6.20 nei membri MajorNdisVersion e MinorNdisVersion della struttura NDIS_MINIPORT_DRIVER_CHARACTERISTICS, che viene passata alla funzione NdisMRegisterMiniportDriver.

• Impostare la versione del driver miniport nel membro MajorDriverVersion e nel membro MinorDriverVersion della struttura NDIS_MINIPORT_DRIVER_CHARACTERISTICS a un valore appropriato specifico per il driver.

• Definire i punti di ingresso diretto della richiesta OID nella struttura NDIS_MINIPORT_DRIVER_CHARACTERISTICS. Il supporto per l'interfaccia di richiesta OID diretta era facoltativo per i driver NDIS 6.1, ma è obbligatorio per i driver NDIS 6.20. Per altre informazioni sull'interfaccia di richiesta OID diretta del driver miniport, vedere richieste OID dell'adattatore Miniport.

inizializzazione dell'adattatore Miniport

• Usare la versione più recente delle interfacce per la pubblicità delle capacità degli adattatori miniport. Le interfacce seguenti hanno funzionalità aggiornate:

  • Risparmio energia
  • Scalabilità del lato ricevente (RSS)
  • Assistenza hardware (VMQ)

• Usare le versioni aggiornate di queste strutture:

  • NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES
  • NDIS_RESTART_GENERAL_ATTRIBUTES
  • NDIS_RECEIVE_SCALE_PARAMETERS
  • NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

  Per informazioni sulla versione della struttura NDIS, vedere Specifiche delle informazioni sulla versione di NDIS.

Percorsi di Codice di Invio e Ricezione

• I driver NDIS 6.20 devono supportare il controllo della limitazione lato ricezione (RST) nell'elaborazione degli interrupt di ricezione. I parametri ReceiveThrottleParameters delle funzioni del gestore DPC MiniportInterruptDPC e MiniportMessageInterruptDPC puntano a una struttura NDIS_RECEIVE_THROTTLE_PARAMETERS. In ingresso al gestore DPC (Deferred Procedure Call), il membro MaxNblsToIndicate della struttura NDIS_RECEIVE_THROTTLE_PARAMETERS specifica il numero massimo di strutture NET_BUFFER_LIST che il driver miniport deve indicare nel DPC. Per altre informazioni su RST, vedere Receive Side Throttle in NDIS 6.20.

• Usare la versione aggiornata della struttura NET_BUFFER.

• Facoltativamente, supportare l'interfaccia VMQ (Virtual Machine Queue). Per altre informazioni su VMQ, vedere Virtual Machine Queue (VMQ) in NDIS 6.20.