NdisClOpenAddressFamilyEx 関数 (ndis.h)

[アーティクル]
08/07/2023

NdisClOpenAddressFamilyEx 関数は、接続指向クライアントの呼び出しマネージャーに関連付けられているアドレスファミリ (AF) を登録します。

構文

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

パラメーター

[in] NdisBindingHandle

NdisOpenAdapterEx が返すハンドルで、呼び出し元がバインドされている次の下位ドライバーのターゲットネットワークインターフェイスカード (NIC) または仮想アダプターを識別します。

[in] AddressFamily

開く呼び出しマネージャーと AF を記述する CO_ADDRESS_FAMILY 構造体へのポインター。

このポインターは、クライアントのへの入力パラメーターです。 ProtocolCoAfRegisterNotify 関数。 NdisClOpenAddressFamilyEx を呼び出します。

[in] ClientAfContext

AF を開いた後にクライアントがこの AF の状態を維持する、呼び出し元が指定した常駐コンテキスト領域へのハンドル。 NDIS は、NdisClOpenAddressFamilyEx への呼び出しが成功した場合、この AF に関する後続のすべての呼び出しで、このハンドルをクライアントに渡します。

[out] NdisAfHandle

呼び出し元が指定した変数へのポインター。 NdisClOpenAddressFamilyEx は 、新しく開かれたアドレスファミリを表すハンドルを返します。

戻り値

NdisClOpenAddressFamilyEx がNDIS_STATUS_PENDING以外のものを返す場合、クライアントは、 ProtocolClOpenAfCompleteEx 関数。それ以外の場合、NDIS は、この操作が完了したときにクライアントの ProtocolClOpenAfCompleteEx 関数を呼び出します。

注釈

CoNDIS クライアントは、から NdisClOpenAddressFamilyEx を 呼び出します。 ProtocolCoAfRegisterNotify 関数。クライアントが AddressFamily パラメーターによって指されている入力バッファーをチェックして、クライアントが呼び出しマネージャーと登録済みアドレスを認識するかどうかを判断した後。 NDIS は、クライアントが有効な AF 構造体を渡したことを確認する呼び出しマネージャーの ProtocolCmOpenAf 関数に NdisClOpenAddressFamilyEx のクライアントの呼び出しを転送します。

NdisClOpenAddressFamilyEx の呼び出しが成功すると、クライアントから呼び出しマネージャーへの通信が設定されます。その後、クライアントは NdisClRegisterSap 関数を呼び出して、着信呼び出しを受信する準備を行うことができます。クライアントは NdisCoCreateVc 関数を呼び出して仮想接続 (VC) を設定して、 NdisClMakeCall 関数を呼び出して発信呼び出しを行うこともできます。

NdisClOpenAddressFamilyEx へのクライアントの呼び出しが失敗した場合、クライアントは NdisUnbindAdapter 関数を呼び出して、基になるミニポートアダプターへのバインドを解放するように NDIS に要求する必要があります。それ以外の場合、クライアントは NdisAfHandle パラメーターで返されるハンドルを保存する必要があります。このハンドルは、指定されたアドレスファミリに関する後続の要求が送信される呼び出しマネージャーを識別します。クライアントは、この返されたハンドルを不透明な変数として扱い、それ以降の NdisXxx 関数呼び出しで変更されておらず、解釈されない状態で渡す必要があります。

NDIS は、クライアントが同じ NdisAfHandle で NdisClCloseAddressFamily を呼び出すまで、AF に関係するすべての呼び出しで ClientAfContext パラメーターからクライアントの登録済み ProtocolClXxx 関数にポインターを渡します。 AF を閉じた後、クライアントは ClientAfContext で割り当てたストレージを解放または再利用できます。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	Irql_Protocol_Driver_Function(ndis)