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 は、クライアントが同じ 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) |