OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS

Die OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS OID fordert einen Anruf-Manager oder einen integrierten MCM-Treiber (Call Manager Miniport) an, um TAPI-Aufrufparameter in NDIS-Aufrufparameter zu übersetzen. Der Client, der diese OID abfragt, verwendet die zurückgegebenen NDIS-Aufrufparameter als Eingabe (formatiert als CO_CALL_PARAMETERS-Struktur ) für NdisClMakeCall, mit dem der Client einen ausgehenden Aufruf abgibt.

Diese OID verwendet eine CO_TAPI_TRANSLATE_TAPI_CALLPARAMS-Struktur, die wie folgt definiert ist:

typedef struct _CO_TAPI_TRANSLATE_TAPI_CALLPARAMS {
    IN  ULONG               ulLineID;
    IN  ULONG               ulAddressID;
    IN  ULONG               ulFlags;
    IN  NDIS_VAR_DATA_DESC  DestAddress;
    IN  NDIS_VAR_DATA_DESC  LineCallParams;
    OUT NDIS_VAR_DATA_DESC  NdisCallParams;
} CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, *PCO_TAPI_TRANSLATE_TAPI_CALLPARAMS;

Die Member dieser Struktur enthalten die folgenden Informationen:

ulLineID
Gibt einen nullbasierten Zeilenbezeichner an, an den der ausgehende Aufruf weitergeleitet wird.

ulAddressID
Gibt einen nullbasierten Adressbezeichner (in der durch ulLineID angegebenen Zeile) an, an die der ausgehende Aufruf weitergeleitet wird.

ulFlags
Der Client muss das CO_TAPI_FLAG_OUTGOING_CALL Bit in ulFlags festlegen. Der Client kann optional das CO_TAPI_USE_DEFAULT_CALLPARAMS Bit in ulFlags festlegen, damit der Anruf-Manager oder MCM-Treiber die LineCallParams ignoriert und die Standard-NDIS-Anrufparameter für das Gerät zurückgibt.

DestAddress
Gibt eine NDIS_VAR_DATA_DESC-Struktur an, die einen Offset vom Anfang der NDIS_VAR_DATA_DESC-Struktur auf eine Zieladresse enthält, die als Zeichenarray formatiert ist. Die NDIS_VAR_DATA_DESC-Struktur enthält auch die Länge der Zieladresse. Die Zieladresse ist die Adresse, an die der ausgehende Anruf weitergeleitet wird.

LineCallParams
Gibt eine NDIS_VAR_DATA_DESC-Struktur an, die einen Offset vom Anfang der NDIS_VAR_DATA_DESC-Struktur zu einer LINE_CALL_PARAMS-Struktur enthält. Die NDIS_VAR_DATA_DESC-Struktur enthält auch die Länge der LINE_CALL_PARAMS-Struktur. Die LINE_CALL_PARAMS-Struktur gibt die TAPI-Aufrufparameter an, die in NDIS-Aufrufparameter übersetzt werden sollen. Weitere Informationen zur LINE_CALL_PARAMS-Struktur finden Sie in der Microsoft Windows SDK- und der Headerdatei ndistapi.h.

NdisCallParams
Gibt eine NDIS_VAR_DATA_DESC-Struktur an, die einen Offset vom Anfang der NDIS_VAR_DATA_DESC-Struktur zu einer CO_CALL_PARAMETERS-Struktur enthält. Die NDIS_VAR_DATA_DESC-Struktur enthält auch die Länge der CO_CALL_PARAMETERS-Struktur . Die CO_CALL_PARAMETERS-Struktur gibt die NDIS-Aufrufparameter an, in die die angegebenen TAPI-Aufrufparameter übersetzt wurden.

Bemerkungen

Wenn die Anforderung erfolgreich ist, füllt der Anruf-Manager oder MCM-Treiber die CO_CALL_PARAMETERS Struktur aus, auf die NdisCallParams verweist, mit den übersetzten NDIS-Aufrufparametern. Der Anruf-Manager oder MCM-Treiber muss die CO_CALL_PARAMETERS-Struktur innerhalb des Abschnitts "Flat Memory" zuordnen, auf den von NdisCallParams verwiesen wird. Der Client schreibt die Gesamtlänge der CO_CALL_PARAMETERS-Struktur in NdisCallParams.Length.

Wenn der Client das CO_TAPI_USE_DEFAULT_CALLPARAMS Bit in ulFlags festlegt, gibt der Client keine TAPI-Aufrufparameter an. In diesem Fall sollte der Anruf-Manager oder MCM-Treiber die Standard-NDIS-Aufrufparameter für das Gerät zurückgeben. Wenn keine Standardmäßigen NDIS-Aufrufparameter für das Gerät vorhanden sind, sollte der Anruf-Manager oder der MCM-Treiber NDIS_STATUS_FAILURE zurückgeben.

Anforderungen

Version: Windows Vista und höher Header: Ntddndis.h (include Ndis.h)