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 は、クライアント NdisClOpenAddressFamilyEx の呼び出しを呼び出しマネージャーの ProtocolCmOpenAf 関数に転送します。これにより、クライアントが有効な AF 構造体を渡したことが保証されます。
NdisClOpenAddressFamilyEx 正常に呼び出 は、クライアントから呼び出しマネージャーへの通信を設定します。 クライアントは、NdisClRegisterSap 関数を呼び出すことによって、着信呼び出しを受信する準備をできます。 クライアントは、NdisClMakeCall 関数を呼び出して発信呼び出しを行うことができるように、NdisCoCreateVc 関数を呼び出すことによって仮想接続 (VC) を設定することもできます。
NdisClOpenAddressFamilyEx を するクライアントの呼び出しが失敗した場合、クライアントは、基になるミニポート アダプターへのバインドを解放する NDIS を要求する NdisUnbindAdapter 関数を呼び出す必要があります。 それ以外の場合、クライアントは、NdisAfHandle パラメーターで返されるハンドルを保存する必要があります。 このハンドルは、指定されたアドレス ファミリに関する後続の要求が送信される通話マネージャーを識別します。 クライアントは、この返されたハンドルを不透明な変数として扱う必要があります。このハンドルは変更されておらず、後続の NdisXxx 関数呼び出しで解釈されません。
NDIS は、クライアントが同じ NdisAfHandle を使用して NdisClCloseAddressFamily を呼び出すまで、AF に関係するすべての後続の呼び 出しで、クライアントの登録済みの ProtocolClXxx 関数に、ClientAfContext パラメーターからポインターを渡します。 AF を閉じた後、クライアントは ClientAfContext で割り当てたストレージ 解放または再利用できます。
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | NDIS 6.0 以降でサポートされています。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | ndis.h (Ndis.h を含む) |
| ライブラリ | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 を する | Irql_Protocol_Driver_Function(ndis) |
NdisClCloseAddressFamily の
NdisClMakeCall の
NdisCoCreateVc の
NdisOpenAdapterEx の
NdisUnbindAdapter の