Funzione NdisIMGetBindingContext (ndis.h)
La funzione NdisIMGetBindingContext consente a un driver di protocollo NDIS di accedere all'area del contesto del dispositivo, creata da un driver intermedio sottostante, per un miniport virtuale a cui è associato il driver del protocollo di livello superiore.
Sintassi
NDIS_HANDLE NdisIMGetBindingContext(
[in] NDIS_HANDLE NdisBindingHandle
);
Parametri
[in] NdisBindingHandle
Handle di associazione restituito dalla funzione NdisOpenAdapterEx nel parametro NdisBindingHandle che identifica il miniport virtuale del driver intermedio successivo a cui è associato il chiamante.
Valore restituito
NdisIMGetBindingContext restituisce un handle all'area del contesto del dispositivo per il miniport virtuale specificato oppure restituisce NULL se non esiste alcuna area di contesto.
Commenti
Un driver di protocollo o un driver intermedio può chiamare NdisIMGetBindingContext dalla funzione ProtocolBindAdapterEx per accedere al contesto del dispositivo per un miniport virtuale a cui è associato. Il contesto del dispositivo fornisce un'area di contesto comune per tutti i driver di protocollo overlying associati allo stesso driver intermedio sottostante.
Tale area di contesto del dispositivo è stata allocata e definita dal driver intermedio di livello inferiore e passata a NDIS in una chiamata a Funzione NdisIMInitializeDeviceInstanceEx .
Tutti i driver di protocollo che chiamano NdisIMGetBindingContext possono presupporre che il driver intermedio sottostante allocato l'area di contesto dal pool non a pagine. Devono considerare l'area del contesto restituita come di sola lettura, mantenendo lo stato configurato dal driver intermedio NDIS sottostante che lo ha definito.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisIMGetBindingContext (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisIMGetBindingContext (NDIS 5.1) in Windows XP. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ndis.h (includere Ndis.h) |
| Libreria | Ndis.lib |
| IRQL | < DISPATCH_LEVEL |
| Regole di conformità DDI | Irql_IM_Function(ndis) |