Función NdisCmOpenAddressFamilyComplete (ndis.h)
NdisCmOpenAddressFamilyComplete devuelve el estado final de la apertura de un administrador de llamadas independiente de un af determinado para un cliente determinado después de que el administrador de llamadas devolvió NDIS_STATUS_PENDING en respuesta a la solicitud original de open-AF del cliente.
Sintaxis
void NdisCmOpenAddressFamilyComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisAfHandle,
[in] NDIS_HANDLE CallMgrAfContext
);
Parámetros
[in] Status
Especifica el estado final de la operación open-AF, ya sea NDIS_STATUS_SUCCESS o cualquier error determinado por CM NDIS_STATUS_ XXX excepto NDIS_STATUS_PENDING.
[in] NdisAfHandle
Especifica el identificador proporcionado por NDIS que se ha introducido en la función ProtocolCmOpenAf del administrador de llamadas, que devolvió NDIS_STATUS_PENDING.
[in] CallMgrAfContext
Especifica el identificador de un área de contexto residente asignada por el autor de la llamada en la que el administrador de llamadas mantiene el estado sobre la apertura de la familia de direcciones de este cliente, incluido NdisAfHandle, si la apertura se realizó correctamente. Si Status no es NDIS_STATUS_SUCCESS, NDIS omite este parámetro.
Valor devuelto
None
Observaciones
Un administrador de llamadas independiente debe llamar a NdisCmOpenAddressFamilyComplete si su función ProtocolCmOpenAf devolvió previamente NDIS_STATUS_PENDING para el NdisAfHandle especificado. El cliente, que inició la operación open-AF pended con una llamada a NdisClOpenAddressFamilyEx, no puede llevar a cabo más operaciones orientadas a la conexión en el mismo enlace hasta que NdisCmOpenAddressFamilyComplete provoca una llamada a ese cliente. Función ProtocolClOpenAfCompleteEx .
Si el autor de la llamada de NdisCmOpenAddressFamilyComplete establece Status en NDIS_STATUS_SUCCESS, NDIS pasa posteriormente el identificador CallMgrAfContext dado como parámetro de entrada a todas las funciones ProtocolCmXxx y ProtocolCoXxx proporcionadas por CM que afectan a la apertura del cliente de la familia de direcciones hasta que el cliente cierra el AF. El administrador de llamadas debe liberar o reutilizar cualquier área de contexto de AF que haya asignado antes de pasar un estado de error a NdisCmOpenAddressFamilyComplete.
Para una apertura correcta, el NDIS proporcionado por NdisAfHandle representa una asociación entre el administrador de llamadas y el cliente para el AF abierto en un controlador de miniporte determinado al que está enlazado el administrador de llamadas y el cliente. Ambos controladores de protocolo deben tratar NdisAfHandle como una variable opaca que se va a pasar, sin modificar y sin interpretar, en llamadas posteriores a las funciones NdisCl/Cm/CoXxx para las que este identificador es un parámetro obligatorio. Para una apertura errónea, el administrador de llamadas debe considerar que NdisAfHandle no es válido cuando NdisMCmOpenAddressFamilyComplete devuelve el control.
Solo los administradores de llamadas independientes, que se registran con NDIS como controladores de protocolo, pueden llamar a NdisCmOpenAddressFamilyComplete. Los controladores de minipuerto orientados a la conexión que proporcionan compatibilidad integrada con la administración de llamadas deben llamar NdisMCmOpenAddressFamilyComplete en su lugar.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisCmOpenAddressFamilyComplete (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulta NdisCmOpenAddressFamilyComplete (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_CallManager_Function(ndis) |