Macro NdisMCmOpenAddressFamilyComplete (ndis.h)
NdisMCmOpenAddressFamilyComplete devuelve el estado final de la solicitud de un cliente, para la que la función ProtocolCmOpenAf del controlador MCM devuelve NDIS_STATUS_PENDING, para abrir la familia de direcciones del controlador MCM.
Sintaxis
void NdisMCmOpenAddressFamilyComplete(
_S_,
_H_,
_C_
);
Parámetros
_S_
Especifica el estado final de la solicitud del cliente para abrir el AF, ya sea NDIS_STATUS_SUCCESS o cualquier NDIS_STATUS_ XXX determinado por el autor de la llamada, excepto NDIS_STATUS_PENDING.
_H_
Especifica el identificador proporcionado por NDIS que se ha introducido en la función ProtocolCmOpenAf del controlador MCM, que devolvió NDIS_STATUS_PENDING.
_C_
Especifica el identificador de un área de contexto residente asignada por el autor de la llamada, en la que el controlador MCM mantiene el estado sobre la apertura de esta familia de direcciones, incluida la NdisAfHandle, si la apertura se realizó correctamente. De lo contrario, NDIS omite este parámetro.
Valor devuelto
Ninguno
Observaciones
Un controlador MCM debe llamar a NdisMCmOpenAddressFamilyComplete si su función ProtocolCmOpenAf devolvió previamente NDIS_STATUS_PENDING para el NdisAfHandle dado. El cliente, que inició la operación open-AF en pended con una llamada a NdisClOpenAddressFamilyEx, no puede llevar a cabo operaciones adicionales orientadas a la conexión en el mismo enlace hasta NdisMCmOpenAddressFamilyComplete provoca una llamada a ese cliente. función protocolClOpenAfCompleteEx.
Si el autor de la llamada de NdisMCmOpenAddressFamilyComplete establece Estado en NDIS_STATUS_SUCCESS, NDIS pasa posteriormente el identificador de callMgrAfContext especificado como parámetro de entrada a todas las funciones protocolcm proporcionadas por el controlador MCMXxx y ProtocolCoXxx que conciernen a la apertura del cliente de la familia de direcciones hasta que el cliente cierra el AF. El controlador MCM debe liberar o reutilizar cualquier área de contexto de AF que haya asignado antes de pasar un estado de error a NdisMCmOpenAddressFamilyComplete.
Para una apertura correcta, el NdisAfHand le suministrado por NDIS representa una asociación entre el controlador MCM y el cliente para el AF abierto. Ambos controladores NDIS deben tratar NdisAfHandle como una variable opaca que se va a pasar, sin modificar y sin modificar, en llamadas posteriores a las funciones NdisCl/Co/MCm/MCoXxx para las que este identificador es un parámetro obligatorio. Para una apertura errónea, el controlador MCM debe considerar el NdisAfHandle no válido cuando NdisMCmOpenAddressFamilyComplete devuelve el control.
Solo los controladores de miniport orientados a la conexión que proporcionan compatibilidad integrada con la administración de llamadas pueden llamar a NdisMCmOpenAddressFamilyComplete. Los administradores de llamadas independientes, que se registran con NDIS como controladores de protocolo, llaman a NdisCmOpenAddressFamilyComplete en su lugar.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisMCmOpenAddressFamilyComplete (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisMCmOpenAddressFamilyComplete (NDIS 5.1)) en Windows XP. |
| de la plataforma de destino de | Escritorio |
| encabezado de | ndis.h (incluya Ndis.h) |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | Irql_MCM_Function(ndis) |