Freigeben über

NdisCoGetTapiCallId-Funktion (ndis.h)

  • Artikel

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_STATUS_SUCCESS
 NDIS hat erfolgreich einen Zeichenfolgenbezeichner für die Vc zurückgegeben.
NDIS_STATUS_BUFFER_TOO_SHORT
 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.
NDIS_STATUS_INVALID_DATA
 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)

Weitere Informationen

NdisClGetProtocolVcContextFromTapiCallId

NdisCoCreateVc