Функция phoneGetID (tapi.h)
Функция phoneGetID возвращает идентификатор устройства для заданного класса устройства, связанного с указанным телефонным устройством.
Синтаксис
LONG phoneGetID(
HPHONE hPhone,
LPVARSTRING lpDeviceID,
LPCSTR lpszDeviceClass
);
Параметры
hPhone
Обработка на открытое телефонное устройство.
lpDeviceID
Указатель на структуру данных типа VARSTRING , в которой возвращается идентификатор устройства. После успешного выполнения запроса это расположение заполняется идентификатором устройства. Формат возвращаемых сведений зависит от метода, используемого классом устройства (API) для именования устройств.
lpszDeviceClass
Указатель на строку, завершающуюся значением NULL, которая указывает класс устройства, идентификатор которого запрашивается. Допустимые строки класса устройства — это строки, используемые в разделе System.ini для идентификации классов устройств.
Возвращаемое значение
Возвращает ноль при успешном выполнении запроса или отрицательное число ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL PHONEERR_OPERATIONUNAVAIL.
Комментарии
Функцию phoneGetID можно использовать для получения идентификатора телефонного устройства, заданного дескриптором телефона. Его также можно использовать для получения идентификатора устройства мультимедиа (для классов устройств, таких как COM, wave, MIDI, phone, line или NDIS), связанных с открытым телефонным устройством. Имена этих классов устройств не чувствительны к регистру. Затем этот идентификатор можно использовать с соответствующим API мультимедиа для выбора соответствующего устройства.
Имена классов устройств см. в разделе Классы устройств TAPI .
Поставщик, который определяет тип носителя для конкретного устройства, также должен определить соответствующий API для конкретного устройства (собственный) для управления устройствами этого типа мультимедиа. Чтобы избежать конфликтов в именах классов устройств, назначенных независимо от разных поставщиков, поставщик должен выбрать имя, которое однозначно идентифицирует как поставщика, так и тип носителя, после него. Например, "intel/video".
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |