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 を含む)。 Status がNDIS_STATUS_SUCCESSされていない場合、NDIS はこのパラメーターを無視します。

戻り値

なし

解説

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

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

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

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

要件

こちらもご覧ください

NdisClOpenAddressFamilyEx

ProtocolClOpenAfCompleteEx

ProtocolCmOpenAf