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 は、TAPI 呼び出し ID 文字列で識別される VC のクライアント VC コンテキストへのハンドルを正常に取得しました。 |
|
クライアント VC コンテキストへのハンドルを取得できませんでした。 |
注釈
呼び出しマネージャーが NdisCoCreateVc を呼び出して TAPI 呼び出し用の VC を作成するとします。 NDIS は、クライアントに VC にハンドルを提供します。 クライアントは、この VC ハンドルを NdisCoGetTapiCallId 関数の呼び出しで渡して、VC の文字列識別子を取得します。 クライアントは、この識別子を Unicode 文字列として NdisClGetProtocolVcContextFromTapiCallId に提示して、VC のコンテキストを取得できます。
クライアントは、管理する VC ごとにコンテキストを作成します。 クライアントは NdisCoGetTapiCallId を 使用して、各 VC の文字列識別子を取得します。 クライアントは各文字列識別子を TAPI アプリケーションに渡して、各 VC を識別します。 その後、TAPI アプリケーションがこれらの文字列識別子の 1 つを VC 関連の操作でクライアントに渡す場合、クライアントは、VC の正しいコンテキストを取得するために、 NdisClGetProtocolVcContextFromTapiCallId の呼び出しで Unicode 文字列としてこの文字列識別子を渡す必要があります。
詳細については、「 UNICODE_STRING 構造」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)」を参照) でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | ndis.h (Ndis.h を含む) |
| Library | Ndis.lib |
| IRQL | DISPATCH_LEVEL |
| DDI コンプライアンス規則 | Irql_Protocol_Driver_Function(ndis) |