Funzione NdisIMGetDeviceContext (ndis.h)
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.
Questa funzione consente a un driver intermedio NDIS miniportInitialize funzione di accedere all'area del contesto di dispositivo allocata dalla relativa funzione ProtocolBindAdapter.
Sintassi
NDIS_HANDLE NdisIMGetDeviceContext(
[in] NDIS_HANDLE MiniportAdapterHandle
);
Parametri
[in] MiniportAdapterHandle
Specifica l'input dell'handle per MiniportInitialize.
Valore restituito
Nella tabella seguente vengono illustrati i valori restituiti per questa funzione.
| Valore | Descrizione |
|---|---|
| NDISIMGETDEVICECONTEXT | Restituisce l'accesso all'area di contesto del dispositivo per la scheda di interfaccia di rete virtuale identificata da MiniportAdapterHandle. |
| NULLO | Se la funzione ProtocolBindAdapter del driver non ha allocato un'area di contesto del dispositivo di questo tipo. |
Osservazioni
Un driver intermedio NDIS MiniportInitialize chiamate di funzione NdisIMGetDeviceContext per accedere all'area di contesto del dispositivo per la scheda di interfaccia di rete virtuale che sta inizializzando. In genere, la memoria per tale area viene fornita dalla funzione ProtocolBindAdapter del driver intermedio, che chiama NdisIMInitializeDeviceInstanceEx con un puntatore a questa area, causando la chiamata della funzione MiniportInitialize del driver. Tuttavia, non è necessario che un driver intermedio disponga di un'area di contesto di questo tipo.
Al ritorno da NdisIMGetDeviceContext, MiniportInitialize configura lo stato definito dal driver per la scheda di interfaccia di rete virtuale con qualsiasi informazione che il writer di driver intermedio intende essere utile per i protocolli di livello ancora più elevato che si associano successivamente alla scheda di interfaccia di rete virtuale.
Successivamente, i protocolli NDIS di livello più elevato associati alla stessa scheda di interfaccia di rete virtuale possono accedere a questa area del contesto di dispositivo chiamando NdisIMGetBindingContext dalle funzioni ProtocolBindAdapter.
versioni del sistema operativo: Windows CE .NET 4.0 e versioni successive.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | ndis.h |
| libreria | Ndis.lib |
| IRQL | IRQL <= DISPATCH_LEVEL |