Функция phoneGetID (tapi.h)

Статья
08/26/2023

Функция 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".