Macro NdisMInitializeWrapper (ndis.h)

Articolo
02/07/2025

Nota NDIS 5. x è stato deprecato e sostituito da NDIS 6. x. Per i nuovi driver NDIS, vedere Driver di rete a partire da Windows Vista. Per informazioni sulla conversione di NDIS 5. driver x a NDIS 6. x, vedere Porting NDIS 5.x Drivers to NDIS 6.0.

NdisMInitializeWrapper notifica a NDIS che un nuovo driver miniport sta inizializzando.

Sintassi

VOID NdisInitializeWrapper(
  _Out_ PNDIS_HANDLE  NdisWrapperHandle,
  _In_ PVOID SystemSpecific1,
  _In_ PVOID SystemSpecific2,
  _In_ PVOID SystemSpecific3
);

Parametri

[out] _a

Puntatore a una variabile fornita dal chiamante in cui NDIS restituisce un handle che si rappresenta. Se la chiamata a NdisMInitializeWrapper ha esito negativo, NDIS imposta la variabile in NdisWrapperHandle su NULL.

[in] _b

Specifica un puntatore di un tipo specifico del sistema.

Per i driver Windows 2000 e versioni successive, si tratta di un puntatore a un input di un oggetto driver opaco alla funzione driverEntry del driver miniport.

[in] _c

Specifica un puntatore di un tipo specifico del sistema.

Per i driver Windows 2000 e versioni successive, si tratta di un puntatore a un input del percorso opaco del Registro di sistema per la funzione driverEntry del driver miniport.

[in] _d

Specifica un puntatore di un tipo specifico del sistema.

Per i driver Windows 2000 e versioni successive, questo puntatore deve essere impostato su NULL quando il driver miniport chiama NdisMInitializeWrapper.

Valore restituito

Nessuno

Osservazioni

Un driver NIC o un driver intermedio deve chiamare NdisMInitializeWrapper prima di chiamare qualsiasi altra funzione NdisXxx. In genere, questa chiamata è l'azione iniziale di qualsiasi funzione di driver di interfaccia di rete DriverEntry, che chiama NdisMRegisterMiniport o NdisIMRegisterLayeredMiniport con il restituito NdisWrapperHandle successivo. I driver intermedi NDIS devono anche chiamare NdisMInitializeWrapper dalla funzione DriverEntry e quindi chiamare NdisMRegisterMiniport o NdisIMRegisterLayeredMiniport con il restituito NdisWrapperHandle.

Tali chiamate successive di un driver a NdisXxx le funzioni di inizializzazione e configurazione devono passare il NdisWrapperHandle come parametro. Di conseguenza, è un parametro di input per la funzione MiniportInitialize.

Se la chiamata a NdisMInitializeWrapper ha esito negativo, NDIS imposta la variabile in NdisWrapperHandle su NULL. Il driver deve sempre controllare il valore di questa variabile dopo NdisMInitializeWrapper restituisce. Se il valore è NULL, il driver deve non riuscire a eseguire la chiamata alla funzione DriverEntry.