NdisClGetProtocolVcContextFromTapiCallId-Funktion (ndis.h)
NdisClGetProtocolVcContextFromTapiCallId ruft den Clientkontext für eine virtuelle Verbindung (VC) ab, die durch eine TAPI-Aufruf-ID-Zeichenfolge identifiziert wird.
Syntax
NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId(
[in] UNICODE_STRING TapiCallId,
[out] PNDIS_HANDLE ProtocolVcContext
);
Parameter
[in] TapiCallId
Unicode-Zeichenfolge, die eine bestimmte VC identifiziert. Diese Zeichenfolge ist die Unicode-Version eines Zeichenfolgenbezeichners, der zuvor von der NdisCoGetTapiCallID-Funktion zurückgegeben wurde.
[out] ProtocolVcContext
Zeiger auf eine vom Aufrufer zugewiesene NDIS_HANDLE, die ein Handle auf den Clientkontext für die VC empfängt. Der Client hat diesen Kontext für NDIS bereitgestellt, wenn er von seinem ProtocolCoCreateVc-Handler zurückgibt.
Rückgabewert
Gibt einen der folgenden status Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
NDIS hat das Handle erfolgreich in den Client-VC-Kontext für die VC abgerufen, die durch die TAPI-Aufruf-ID-Zeichenfolge identifiziert wurde. |
|
Fehler beim Abrufen des Handle in den Client-VC-Kontext. |
Hinweise
Angenommen, ein Anruf-Manager ruft NdisCoCreateVc auf, um eine VC für einen TAPI-Aufruf zu erstellen. NDIS stellt wiederum den Handle für die VC an einen Client bereit. Der Client übergibt dieses VC-Handle in einem Aufruf an die NdisCoGetTapiCallId-Funktion , um einen Zeichenfolgenbezeichner für die VC abzurufen. Der Client kann diesen Bezeichner dann als Unicode-Zeichenfolge für NdisClGetProtocolVcContextFromTapiCallId darstellen, um seinen Kontext für die VC abzurufen.
Der Client erstellt einen Kontext für jede VC, die er verwaltet. Der Client verwendet NdisCoGetTapiCallId , um einen Zeichenfolgenbezeichner für jede VC abzurufen. Der Client übergibt jeden Zeichenfolgenbezeichner an eine TAPI-Anwendung, um jede VC zu identifizieren. Wenn später eine TAPI-Anwendung einen dieser Zeichenfolgenbezeichner in einem VC-bezogenen Vorgang an den Client übergibt, muss der Client diesen Zeichenfolgenbezeichner als Unicode-Zeichenfolge in einem Aufruf von NdisClGetProtocolVcContextFromTapiCallId übergeben, um den richtigen Kontext für die VC abzurufen.
Weitere Informationen finden Sie in der UNICODE_STRING-Struktur .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisClGetProtocolVcContextFromTapiCallId (NDIS 5.1)) in Windows XP. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (einschließlich Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Protocol_Driver_Function(ndis) |