次の方法で共有

NdisCoGetTapiCallId 関数 (ndis.h)

  • [アーティクル]

NdisCoGetTapiCallId は、TAPI アプリケーションが特定の NDIS 仮想接続 (VC) を識別するために使用できる文字列を取得します。

構文

NDIS_STATUS NdisCoGetTapiCallId(
  [in]      NDIS_HANDLE NdisVcHandle,
  [in, out] PVAR_STRING TapiCallId
);

パラメーター

[in] NdisVcHandle

VC への NDIS ハンドルを指定します。 このハンドルは、VC が最初に NdisCoCreateVc 関数を使用して作成されたときに NDIS によって提供されました。

[in, out] TapiCallId

VAR_STRING型のデータ構造を受け取る呼び出し元によって割り当てられたバッファーへのポインター。 正常に戻ると、この構造体は TAPI アプリケーションが VC を識別するために使用できる文字列を記述します。

戻り値

次のいずれかの状態値を返します。

リターン コード 形容
NDIS_STATUS_SUCCESS
 NDIS は VC の文字列識別子を正常に返しました。
NDIS_STATUS_BUFFER_TOO_SHORT
 VAR_STRING構造体の ulTotalSize メンバーは、バッファーのサイズが VC を識別する文字列を保持するのに十分な大きさではないことを指定します。 NdisCoGetTapiCallId 、VAR_STRING構造体の ulNeededSize メンバーを必要なサイズ (バイト単位) に設定します。
NDIS_STATUS_INVALID_DATA
 NdisVcHandle で指定された VC へのハンドルが無効です。

備考

呼び出しマネージャーが NDISCoCreateVc 呼び出して TAPI 呼び出し用の VC を作成するとします。 NDIS は、クライアントに VC にハンドルを提供します。 クライアントは、この VC ハンドルを NdisCoGetTapiCallId 関数の呼び出しで渡して、VC を識別する文字列を取得します。 クライアントは、この文字列識別子を TAPI アプリケーションに渡して VC を識別できます。

クライアントは、管理する VC ごとにコンテキストを作成します。 クライアントは、NdisCoGetTapiCallId を使用して、各 VC の文字列識別子を取得します。 クライアントは、各 VC を識別するために、各文字列識別子を TAPI アプリケーションに渡します。 その後、TAPI アプリケーションが VC 関連の操作でこれらの文字列識別子のいずれかをクライアントに渡す場合、クライアントはこの文字列識別子を Unicode 文字列として呼び出しで渡す必要があります。NdisClGetProtocolVcContextFromTapiCallId を して、VC の正しいコンテキストを取得します。

VAR_STRING構造の詳細については、「TAPI Objects」を参照してください。

必要条件

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

関連項目

NdisClGetProtocolVcContextFromTapiCallId の

NdisCoCreateVc の