NdisMCmOpenAddressFamilyComplete マクロ (ndis.h)
NdisMCmOpenAddressFamilyComplete は、MCM ドライバーの ProtocolCmOpenAf 関数が MCM ドライバーのアドレス ファミリを開くためにNDIS_STATUS_PENDING返したクライアントの要求の最終的な状態を返します。
構文
void NdisMCmOpenAddressFamilyComplete(
_S_,
_H_,
_C_
);
パラメーター
_S_
AF を開くクライアントの要求の最終的な状態 (NDIS_STATUS_SUCCESSまたは呼び出し元によって決定された XXX NDIS_STATUS_ NDIS_STATUS_PENDINGを除 く) を指定します。
_H_
NDIS_STATUS_PENDINGを返す MCM ドライバーの ProtocolCmOpenAf 関数に入力された NDIS 提供のハンドルを指定します。
_C_
呼び出し元によって割り当てられた常駐コンテキスト領域へのハンドルを指定します。MCM ドライバーは、開いているが成功した場合に NdisAfHandle を含むアドレス ファミリのこのクライアントのオープンに関する状態を維持します。 それ以外の場合、NDIS はこのパラメーターを無視します。
戻り値
なし
解説
指定された NdisAfHandle の ProtocolCmOpenAf 関数が以前にNDIS_STATUS_PENDINGを返した場合、MCM ドライバーは NdisMCmOpenAddressFamilyComplete を呼び出す必要があります。 NdisClOpenAddressFamilyEx の呼び出しによってペンドされた open-AF 操作を開始したクライアントは、NdisMCmOpenAddressFamilyComplete がそのクライアントの呼び出しを行うまで、同じバインディングに対してそれ以上の接続指向操作を実行できません ProtocolClOpenAfCompleteEx 関数。
NdisMCmOpenAddressFamilyComplete の呼び出し元が Status をNDIS_STATUS_SUCCESSに設定した場合、NDIS は、クライアントが AF を閉じるまで、クライアントがアドレス ファミリを開いたかどうかに関するすべての MCM ドライバー指定の ProtocolCmXxx および ProtocolCoXxx 関数に、指定された CallMgrAfContext ハンドルを入力パラメーターとして渡します。 MCM ドライバーは、エラー状態を NdisMCmOpenAddressFamilyComplete に渡す前に、割り当てられた AF コンテキスト領域を解放または再利用する必要があります。
正常に開いた場合、NDIS 提供の NdisAfHandle は、開かれた AF の MCM ドライバーとクライアント間の関連付けを表します。 どちらの NDIS ドライバーも、このハンドルが必要なパラメーターである NdisCl/Co/MCm/MCoXxx 関数への後続の呼び出しで、 NdisAfHandle を不透明な変数として渡し、変更および解釈されないものとして扱う必要があります。 開けなかった場合、NdisMCmOpenAddressFamilyComplete がコントロールを返すとき、MCM ドライバーは NdisAfHandle が無効であると見なす必要があります。
統合された呼び出し管理サポートを提供する接続指向のミニポート ドライバーのみが NdisMCmOpenAddressFamilyComplete を呼び出すことができます。 スタンドアロン呼び出しマネージャーは、プロトコル ドライバーとして NDIS に自分自身を登録し、代わりに NdisCmOpenAddressFamilyComplete を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisMCmOpenAddressFamilyComplete (NDIS 5.1)」を参照) でサポートされています。 Windows XP での NDIS 5.1 ドライバー (「NdisMCmOpenAddressFamilyComplete (NDIS 5.1)」を参照) でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | ndis.h (Ndis.h を含む) |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 | Irql_MCM_Function(ndis) |