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 devolvió 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 este cliente de la familia de direcciones, incluido NdisAfHandle, si la apertura se realizó correctamente. De lo contrario, NDIS omite este parámetro.

Valor devuelto

None

Observaciones

Un controlador MCM debe llamar a NdisMCmOpenAddressFamilyComplete si su función ProtocolCmOpenAf devolvió previamente NDIS_STATUS_PENDING para el NdisAfHandle especificado. El cliente, que inició la operación de 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 NdisMCmOpenAddressFamilyComplete provoca una llamada a ese cliente. Función ProtocolClOpenAfCompleteEx .

Si el autor de la llamada de NdisMCmOpenAddressFamilyComplete 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 el controlador MCM que afectan 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 NDIS proporcionado por NdisAfHandle 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 interpretar, en llamadas posteriores a funciones NdisCl/Co/MCm/MCoXxx para las que este identificador es un parámetro obligatorio. En el caso de un error abierto, el controlador MCM debe considerar que NdisAfHandle no es válido cuando NdisMCmOpenAddressFamilyComplete devuelve el control.

Solo los controladores de minipuerto 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	Value
Cliente mínimo compatible	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 (consulta NdisMCmOpenAddressFamilyComplete (NDIS 5.1)) en Windows XP.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_MCM_Function(ndis)

Consulte también

NdisAllocateFromNPagedLookasideList

NdisClOpenAddressFamilyEx

NdisCmOpenAddressFamilyComplete

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf