次の方法で共有

NdisCmOpenAddressFamilyComplete 関数 (ndis.h)

  • [アーティクル]

NdisCmOpenAddressFamilyComplete は、そのクライアントの元の open-AF 要求に応答して呼び出しマネージャーがNDIS_STATUS_PENDINGを返した後、特定のクライアントの特定の AF のスタンドアロン呼び出しマネージャーが開いた最終的な状態を返します。

構文

void NdisCmOpenAddressFamilyComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisAfHandle,
  [in] NDIS_HANDLE CallMgrAfContext
);

パラメーター

[in] Status

NDIS_STATUS_PENDINGを除き、NDIS_STATUS_SUCCESSまたは CM で決定されたエラー NDIS_STATUS_ XXX、open-AF 操作の最終的な状態を指定します。

[in] NdisAfHandle

呼び出しマネージャーの ProtocolCmOpenAf 関数に入力された NDIS 提供のハンドルを指定します。これは、NDIS_STATUS_PENDING返されます。

[in] CallMgrAfContext

呼び出しマネージャーがアドレス ファミリのこのクライアントのオープンに関する状態を維持する呼び出し元割り当て常駐コンテキスト領域へのハンドルを指定します。これには、開きが成功した場合は、NdisAfHandleが含まれます。 状態 がNDIS_STATUS_SUCCESSされていない場合、NDIS はこのパラメーターを無視します。

戻り値

何一つ

備考

スタンドアロンの呼び出しマネージャーは、ProtocolCmOpenAf 関数が以前に指定された NdisAfHandle のNDIS_STATUS_PENDINGを返した場合、NdisCmOpenAddressFamilyComplete 呼び出す必要があります。 NdisClOpenAddressFamilyEx の呼び出しでペンドされた open-AF 操作を開始したクライアントは、NdisCmOpenAddressFamilyComplete がそのクライアントの呼び出しを行うまで、同じバインディングに対してさらに接続指向の操作を実行できませんProtocolClOpenAfCompleteEx 関数を します。

NdisCmOpenAddressFamilyComplete の呼び出し元 状態 をNDIS_STATUS_SUCCESSに設定する場合は、 その後、NDIS は、指定された CallMgrAfContext ハンドルを入力パラメーターとして、クライアントが AF を閉じるまで、クライアントがアドレス ファミリを開く場合に関係するすべての CM 提供の ProtocolCmXxx および ProtocolCoXxx 関数に渡します。 呼び出しマネージャーは、NdisCmOpenAddressFamilyComplete にエラー状態を渡す前に、割り当てた AF コンテキスト領域を解放または再利用する必要があります。

正常に開いた場合、NDIS 提供の NdisAfHandle は、呼び出しマネージャーとクライアントがバインドされている特定のミニポート ドライバーで開かれた AF の呼び出しマネージャーとクライアントの間の関連付けを表します。 どちらのプロトコル ドライバーも、NdisAfHandle を、このハンドルが必要なパラメーターである NdisCl/Cm/CoXxx 関数への後続の呼び出しで渡される不透明な変数として扱う必要があります。 失敗したオープンの場合、NdisMCmOpenAddressFamilyComplete がコントロールを返す場合、呼び出しマネージャーは ndisAfHandle が無効であると見なす必要があります。

プロトコル ドライバーとして NDIS に自分自身を登録するスタンドアロンの呼び出しマネージャーのみが、NdisCmOpenAddressFamilyComplete 呼び出すことができます。 統合された呼び出し管理のサポートを提供する接続指向ミニポート ドライバーは、呼び出す必要があります代わりに NdisMCmOpenAddressFamilyComplete を します。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (NdisCmOpenAddressFamilyComplete (NDIS 5.1) を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (NdisCmOpenAddressFamilyComplete (NDIS 5.1) を参照) でサポートされています。
ターゲット プラットフォーム の デスクトップ
ヘッダー ndis.h (Ndis.h を含む)
ライブラリ Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 を する Irql_CallManager_Function(ndis)

関連項目

NdisAllocateFromNPagedLookasideList の

NdisClOpenAddressFamilyEx の

NdisMCmOpenAddressFamilyComplete の

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf