NdisCoGetTapiCallId 関数 (ndis.h)

  • [アーティクル]

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

構文

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

パラメーター

[in] NdisVcHandle

VC への NDIS ハンドルを指定します。 このハンドルは、最初に NdisCoCreateVc 関数を使用して VC が作成されたときに 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 の文字列識別子を取得します。 クライアントは各文字列識別子を TAPI アプリケーションに渡して、各 VC を識別します。 その後、TAPI アプリケーションがこれらの文字列識別子の 1 つを VC 関連の操作でクライアントに渡す場合、クライアントはこの文字列識別子を Unicode 文字列として に渡す必要があります。VC の正しいコンテキストを取得する NdisClGetProtocolVcContextFromTapiCallId。

VAR_STRING構造体の詳細については、「 TAPI オブジェクト」を参照してください。

要件

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

こちらもご覧ください

NdisClGetProtocolVcContextFromTapiCallId

NdisCoCreateVc