Macro NdisMInitializeWrapper (ndis.h)
Nota NDIS 5. x è stato deprecato ed è sostituito da NDIS 6. x. Per il nuovo sviluppo di 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 Conversione di driver NDIS 5.x in 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 rappresenta se stesso. 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 dell'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 registro opaco 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 di interfaccia di rete o un driver intermedio deve chiamare NdisMInitializeWrapper prima di chiamare qualsiasi altra funzione NdisXxx. In genere, questa chiamata è l'azione iniziale di qualsiasi funzione DriverEntry del driver di interfaccia di rete, che chiama NdisMRegisterMiniport o NdisIMRegisterLayeredMiniport con il NdisWrapperHandle restituito. Anche i driver intermedi NDIS devono chiamare NdisMInitializeWrapper dalla funzione DriverEntry e quindi chiamare NdisMRegisterMiniport o NdisIMRegisterLayeredMiniport con il valore restituito NdisWrapperHandle.
Tali chiamate successive di un driver alle funzioni di inizializzazione e configurazione di NdisXxx devono passare 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 che NdisMInitializeWrapper restituisce . Se il valore è NULL, il driver deve non riuscire la chiamata alla funzione DriverEntry .
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ndis.h |
| IRQL | PASSIVE_LEVEL |