NdisCoGetTapiCallId-Funktion (ndis.h)
NdisCoGetTapiCallId ruft eine Zeichenfolge ab, die TAPI-Anwendungen verwenden können, um eine bestimmte virtuelle NDIS-Verbindung (NDIS Virtual Connection, VC) zu identifizieren.
Syntax
NDIS_STATUS NdisCoGetTapiCallId(
[in] NDIS_HANDLE NdisVcHandle,
[in, out] PVAR_STRING TapiCallId
);
Parameter
[in] NdisVcHandle
Gibt das NDIS-Handle für den Vc an. Dieses Handle wurde von NDIS bereitgestellt, als die Vc ursprünglich mit der NdisCoCreateVc-Funktion erstellt wurde.
[in, out] TapiCallId
Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der eine Datenstruktur vom Typ VAR_STRING empfängt. Nach erfolgreicher Rückgabe beschreibt diese Struktur eine Zeichenfolge, die TAPI-Anwendungen verwenden können, um den Nachweis zu identifizieren.
Rückgabewert
Gibt einen der folgenden status Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
NDIS hat erfolgreich einen Zeichenfolgenbezeichner für die Vc zurückgegeben. |
|
Der ulTotalSize-Member der VAR_STRING-Struktur gibt an, dass die Größe des Puffers nicht groß genug ist, um die Zeichenfolge zu enthalten, die den Vc identifiziert. NdisCoGetTapiCallId legt den ulNeededSize-Member der VAR_STRING-Struktur auf die erforderliche Größe in Bytes fest. |
|
Das Handle für die von NdisVcHandle angegebene Vc ist ungültig. |
Hinweise
Angenommen, ein Anrufmanager ruft NdisCoCreateVc auf, um eine Vc für einen TAPI-Anruf zu erstellen. NDIS wiederum stellt das Handle an den Vc an einen Client bereit. Der Client übergibt dieses VC-Handle in einem Aufruf der NdisCoGetTapiCallId-Funktion , um eine Zeichenfolge abzurufen, die den Vc identifiziert. Der Client kann diesen Zeichenfolgenbezeichner an eine TAPI-Anwendung übergeben, um den Nachweis zu identifizieren.
Der Client erstellt einen Kontext für jede von ihm verwaltete Vc. Der Client verwendet NdisCoGetTapiCallId , um einen Zeichenfolgenbezeichner für jede Vc abzurufen. Der Client übergibt jeden Zeichenfolgenbezeichner an eine TAPI-Anwendung, um die einzelnen Nachweise zu identifizieren. Wenn eine TAPI-Anwendung später einen dieser Zeichenfolgenbezeichner in einem VC-bezogenen Vorgang an den Client übergibt, muss der Client diesen Zeichenfolgenbezeichner in einem Aufruf von als Unicode-Zeichenfolge übergeben. NdisClGetProtocolVcContextFromTapiCallId , um den richtigen Kontext für den Vc abzurufen.
Weitere Informationen zur VAR_STRING-Struktur finden Sie unter TAPI-Objekte.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisCoGetTapiCallId (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisCoGetTapiCallId (NDIS 5.1)) in Windows XP. |
| Zielplattform | Desktop |
| Kopfzeile | ndis.h (include Ndis.h) |
| Bibliothek | Ndis.lib |
| IRQL | DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Connection_Function(ndis) |