TSPI_lineSetMediaMode-Funktion (tspi.h)
Die TSPI_lineSetMediaMode-Funktion ändert die Medien des Aufrufs, wie sie in der LINECALLINFO-Struktur des Aufrufs gespeichert sind.
Syntax
LONG TSPIAPI TSPI_lineSetMediaMode(
HDRVCALL hdCall,
DWORD dwMediaMode
);
Parameter
hdCall
Das Handle für den Anruf, der sich einer Änderung des Medientyps unterliegt. Der Anrufstatus von hdCall kann ein beliebiger Zustand sein.
dwMediaMode
Die neuen Medientypen für den Anruf. Solange das LINEMEDIAMODE_UNKNOWN Medientypflag festgelegt ist, können auch mehrere andere Medientypflags festgelegt werden. Dies wird verwendet, um den Medientyp eines Aufrufs als nicht vollständig festgelegt zu identifizieren, aber auf einen von nur einer kleinen Gruppe von angegebenen Medientypen beschränkt. Wenn das flag LINEMEDIAMODE_UNKNOWN nicht festgelegt ist, kann nur ein einzelner Medientyp angegeben werden. Dieser Parameter verwendet eine (oder mehrere) der LINEMEDIAMODE_ Konstanten.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Hinweise
Abgesehen davon, dass die Medien des Aufrufs, die in der LINECALLINFO-Struktur des Aufrufs gespeichert sind, geändert werden, ist dieses Verfahren lediglich eine Empfehlung in dem Sinne, dass es eine erwartete Medienänderung angibt, die im Begriff ist, den Aufruf zu ändern, anstatt eine bestimmte Änderung für den Aufruf zu erzwingen. Die typische Verwendung besteht darin, den Medientyp eines Aufrufs auf einen bestimmten bekannten Medientyp festzulegen oder mögliche Medientypen auszuschließen, solange der Medientyp des Aufrufs nicht vollständig bekannt ist (das Unknown-Medientypflag ist festgelegt).
TAPI übernimmt die folgenden Garantien für den übergebenen Medientyp: (1) Es ist mindestens ein Bit festgelegt, (2) es sind keine reservierten Bits festgelegt, und (3) wenn mehr als ein Bit festgelegt ist, wird auch "Unbekannt" festgelegt. Der Dienstanbieter muss alle weiteren Gültigkeitsprüfungen der Medientypen durchführen, z. B. ob Medientypen tatsächlich vom Dienstanbieter unterstützt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |