Función NdisIMGetBindingContext (ndis.h)
La función NdisIMGetBindingContext permite que un controlador de protocolo NDIS acceda al área de contexto del dispositivo, creada por un controlador intermedio subyacente, para un miniporte virtual al que está enlazado el controlador de protocolo de nivel superior.
Sintaxis
NDIS_HANDLE NdisIMGetBindingContext(
[in] NDIS_HANDLE NdisBindingHandle
);
Parámetros
[in] NdisBindingHandle
Identificador de enlace que la función NdisOpenAdapterEx devolvió en el parámetro NdisBindingHandle que identifica la miniporte virtual del siguiente controlador intermedio inferior al que está enlazado el autor de la llamada.
Valor devuelto
NdisIMGetBindingContext devuelve un identificador al área de contexto del dispositivo para el miniporte virtual especificado o devuelve NULL si no existe dicho área de contexto.
Comentarios
Un controlador de protocolo o controlador intermedio puede llamar a NdisIMGetBindingContext desde su función ProtocolBindAdapterEx para acceder al contexto del dispositivo para un miniporte virtual al que está enlazado. El contexto del dispositivo proporciona un área de contexto común para todos los controladores de protocolo excesivamente enlazados al mismo controlador intermedio subyacente.
Este área de contexto de dispositivo se asignó y definió mediante el controlador intermedio NDIS de nivel inferior y se pasó a NDIS en una llamada a . Función NdisIMInitializeDeviceInstanceEx .
Todos los controladores de protocolo que llaman a NdisIMGetBindingContext pueden suponer de forma segura que el controlador intermedio subyacente asignó su área de contexto desde el grupo no paginado. Deben tratar el área de contexto devuelta como de solo lectura, conservando el estado configurado por el controlador intermedio NDIS subyacente que lo definió.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisIMGetBindingContext (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulta NdisIMGetBindingContext (NDIS 5.1)) en Windows XP. |
| Plataforma de destino | Escritorio |
| Encabezado | ndis.h (incluya Ndis.h) |
| Library | Ndis.lib |
| IRQL | < DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | Irql_IM_Function(ndis) |