функция phoneGetIDA (tapi.h)

Функция phoneGetID возвращает идентификатор устройства для заданного класса устройства, связанного с указанным телефонным устройством.

Синтаксис

LONG phoneGetIDA(
  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, волна, MIDI, телефон, линия или NDIS), связанные с открытым телефонным устройством. Имена этих классов устройств не учитывает регистр. Затем этот идентификатор можно использовать с соответствующим API мультимедиа для выбора соответствующего устройства.

См. классы устройств TAPI для имен классов устройств.

Поставщик, определяющий тип носителя для конкретного устройства, также должен определить соответствующий API для конкретного устройства (частного) для управления устройствами типа носителя. Чтобы избежать конфликтов в именах классов устройств, назначенных независимо от разных поставщиков, поставщик должен выбрать имя, которое однозначно идентифицирует поставщика и, следуя за ним, тип носителя. Например: intel/video.

Заметка

Заголовок tapi.h определяет phoneGetID как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

дополнительных функций телефонной службы

Обзор TAPI 2.2

VARSTRING