Función NdisClOpenAddressFamilyEx (ndis.h)

Artículo
02/29/2024

La función NdisClOpenAddressFamilyEx registra una familia de direcciones (AF) asociada a un administrador de llamadas para un cliente orientado a la conexión.

Sintaxis

NDIS_STATUS NdisClOpenAddressFamilyEx(
  [in]  NDIS_HANDLE        NdisBindingHandle,
  [in]  PCO_ADDRESS_FAMILY AddressFamily,
  [in]  NDIS_HANDLE        ClientAfContext,
  [out] PNDIS_HANDLE       NdisAfHandle
);

Parámetros

[in] NdisBindingHandle

Identificador al que devuelve NdisOpenAdapterEx y que identifica la tarjeta de interfaz de red (NIC) de destino o el adaptador virtual del controlador inferior al que está enlazado el autor de la llamada.

[in] AddressFamily

Puntero a una estructura de CO_ADDRESS_FAMILY que describe el administrador de llamadas y af que se va a abrir.

Este puntero es un parámetro de entrada para el cliente. Función ProtocolCoAfRegisterNotify , que llama a NdisClOpenAddressFamilyEx.

[in] ClientAfContext

Identificador de un área de contexto residente proporcionada por el autor de la llamada en la que el cliente mantiene el estado de este AF después de que se haya abierto el AF. NDIS devuelve este identificador al cliente en todas las llamadas posteriores relativas a este AF si la llamada a NdisClOpenAddressFamilyEx se realiza correctamente.

[out] NdisAfHandle

Puntero a una variable proporcionada por el autor de la llamada en la que NdisClOpenAddressFamilyEx devuelve un identificador que representa la familia de direcciones recién abierta.

Valor devuelto

Cuando NdisClOpenAddressFamilyEx devuelve algo distinto de NDIS_STATUS_PENDING, el cliente debe realizar una llamada interna a su Función ProtocolClOpenAfCompleteEx . De lo contrario, NDIS llama a la función ProtocolClOpenAfCompleteEx del cliente cuando se completa esta operación.

Comentarios

Un cliente de CoNDIS llama a NdisClOpenAddressFamilyEx desde su La función ProtocolCoAfRegisterNotify , después de que el cliente compruebe el búfer de entrada al que apunta el parámetro AddressFamily para determinar si el cliente reconoce el administrador de llamadas y las direcciones registradas. NDIS reenvía la llamada del cliente de NdisClOpenAddressFamilyEx a la función ProtocolCmOpenAf del administrador de llamadas, lo que garantiza que el cliente haya pasado una estructura de AF válida.

Una llamada correcta a NdisClOpenAddressFamilyEx configura la comunicación desde el cliente a un administrador de llamadas. Después, el cliente puede prepararse para recibir llamadas entrantes mediante una llamada a la función NdisClRegisterSap . El cliente también puede configurar una conexión virtual (VC) llamando a la función NdisCoCreateVc para que pueda realizar una llamada saliente llamando a la función NdisClMakeCall .

Si se produce un error en la llamada del cliente a NdisClOpenAddressFamilyEx , el cliente debe llamar a la función NdisUnbindAdapter para solicitar a NDIS que libere su enlace al adaptador de miniport subyacente. De lo contrario, el cliente debe guardar el identificador que se devuelve en el parámetro NdisAfHandle . Este identificador identifica al administrador de llamadas al que se dirigen las solicitudes posteriores relativas a la familia de direcciones especificadas. El cliente debe tratar este identificador devuelto como una variable opaca, pasándolo sin modificar y sin interpretar en llamadas de función NdisXxx posteriores.

NDIS pasa el puntero del parámetro ClientAfContext a las funciones ProtocolClXxx registradas del cliente en todas las llamadas posteriores que afectan al AF hasta que el cliente llama a NdisClCloseAddressFamily con el mismo NdisAfHandle . Una vez cerrado el AF, el cliente puede liberar o reutilizar el almacenamiento que asignó en ClientAfContext .

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite en NDIS 6.0 y versiones posteriores.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	Irql_Protocol_Driver_Function(ndis)