NdisClGetProtocolVcContextFromTapiCallId 関数 (ndis.h)

NdisClGetProtocolVcContextFromTapiCallId TAPI 呼び出し ID 文字列によって識別される仮想接続 (VC) のクライアント コンテキストを取得します。

構文

NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId(
  [in]  UNICODE_STRING TapiCallId,
  [out] PNDIS_HANDLE   ProtocolVcContext
);

パラメーター

[in] TapiCallId

特定の VC を識別する Unicode 文字列。 この文字列は、NdisCoGetTapiCallID 関数によって以前に返された文字列識別子の Unicode バージョンです。

[out] ProtocolVcContext

VC のクライアント コンテキストへのハンドルを受け取る呼び出し元によって割り当てられたNDIS_HANDLEへのポインター。 クライアントは、ProtocolCoCreateVc ハンドラーから返されたときに NDIS にこのコンテキストを提供しました。

戻り値

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

リターン コード	形容
NDIS_STATUS_SUCCESS	NDIS は、TAPI 呼び出し ID 文字列で識別される VC のクライアント VC コンテキストへのハンドルを正常に取得しました。
NDIS_STATUS_FAILURE	クライアント VC コンテキストへのハンドルを取得できませんでした。

備考

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

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

詳細については、UNICODE_STRING 構造を参照してください。

必要条件

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

関連項目

NdisCoCreateVc の

NdisCoGetTapiCallId の

UNICODE_STRING