次の方法で共有


NdisClOpenAddressFamilyEx 関数 (ndis.h)

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 は、クライアントが同じ NdisAfHandleNdisClCloseAddressFamily を呼び出すまで、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)

こちらもご覧ください

CO_ADDRESS_FAMILY

NdisAllocateFromNPagedLookasideList

NdisClCloseAddressFamily

NdisClMakeCall

NdisClRegisterSap

NdisCoCreateVc

NdisOpenAdapterEx

NdisUnbindAdapter

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf

ProtocolCoAfRegisterNotify