次の方法で共有

NdisMCmOpenAddressFamilyComplete マクロ (ndis.h)

  • [アーティクル]

NdisMCmOpenAddressFamilyComplete は、MCM ドライバーの ProtocolCmOpenAf 関数がNDIS_STATUS_PENDING返したクライアントの要求の最終的な状態を返して、MCM ドライバーのアドレス ファミリを開きます。

構文

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 はこのパラメーターを無視します。

戻り値

何一つ

備考

MCM ドライバーは、指定された NdisAfHandle に対して以前に NDIS_STATUS_PENDING を返した ProtocolCmOpenAf 関数の場合、NdisMCmOpenAddressFamilyComplete 呼び出す必要があります。 NdisClOpenAddressFamilyEx の呼び出しを使用して pended 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) を参照) でサポートされています。
ターゲット プラットフォーム の デスクトップ
ヘッダー ndis.h (Ndis.h を含む)
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 を する Irql_MCM_Function(ndis)

関連項目

NdisAllocateFromNPagedLookasideList の

NdisClOpenAddressFamilyEx の

NdisCmOpenAddressFamilyComplete の

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf