NdisClIncomingCallComplete 関数 (ndis.h)

[アーティクル]
08/07/2023

NdisClIncomingCallComplete は、クライアントの ProtocolClIncomingCall 関数が以前にNDIS_STATUS_PENDING返した、提供された着信呼び出しに対するクライアントの承諾または拒否を返します。

構文

void NdisClIncomingCallComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

パラメーター

[in] Status

クライアントが提供された呼び出しを受け入れる場合は、NDIS_STATUS_SUCCESS に設定されます。それ以外の場合、このパラメーターは、NDIS_STATUS_PENDINGを除く任意のNDIS_STATUS_XXX に設定して、クライアントが決定した呼び出しを拒否する理由を示すことができます。

[in] NdisVcHandle

着信呼び出しを表す呼び出しマネージャーによって作成された VC へのハンドルを指定します。クライアントは、入力パラメーターとして渡された ProtocolVcContext によって指定された VC ごとの状態からこのハンドルを取得しました。 ProtocolClIncomingCall 関数。

[in] CallParameters

CO_CALL_PARAMETERS 型の構造体へのポインター。着信呼び出しの呼び出しパラメーターを指定します。

戻り値

なし

解説

クライアントの ProtocolClIncomingCall 関数が、以前に NdisClRegisterSap を使用してクライアントによって登録された特定の SAP で提供される呼び出しのNDIS_STATUS_PENDINGを返す場合、クライアントは、提供された呼び出しを受け入れるか拒否するかを示すために、その後 NdisClIncomingCallComplete を呼び出す必要があります。

NdisClIncomingCallComplete を呼び出す前に、このようなクライアントは NdisClModifyCallQoS を 1 回以上呼び出すことで、着信呼び出しの許容されるサービス品質に関する合意に達するか、クライアントが QoS を変更しようとする試みが合意なしにクライアントによって決定された制限に達したため、提供された呼び出しを拒否する必要があると判断するまで、呼び出しマネージャーとネゴシエートできます。

クライアントが ProtocolClIncomingCall 関数に渡される呼び出しパラメーターを変更した場合は、これらの変更を NdisClIncomingCallComplete に渡すときに、CO_CALL_PARAMETERS構造体の Flags メンバーを CALL_PARAMETERS_CHANGED に設定する必要があります。呼び出しマネージャーが、呼び出しパラメーターに対するクライアントの提案された変更を受け入れるか拒否するかに応じて、NDIS はその後、クライアントの ProtocolClCallConnected 関数またはその ProtocolClIncomingCloseCall 関数をそれぞれ指定します。

NdisClIncomingCallComplete を呼び出すと、NDIS は CM のを呼び出します。 ProtocolCmIncomingCallComplete 関数。 NDIS は、クライアントが指定した NdisClIncomingCallComplete のパラメーターを ProtocolCmIncomingCallComplete に入力パラメーターとして渡します。

クライアントが Status を NDIS_STATUS_SUCCESS 以外の値に設定して提供された呼び出しを拒否した場合、クライアントは NdisClIncomingCallComplete の呼び出しが発生するとすぐに CallParameters ポインターを無効と見なす必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (NdisClIncomingCallComplete (NDIS 5.1) を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisClIncomingCallComplete (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	Irql_Protocol_Driver_Function(ndis)