функция TSPI_phoneGetID (tspi.h)
Функция TSPI_phoneGetID возвращает идентификатор устройства для заданного класса устройства, связанного с указанным телефонным устройством.
Синтаксис
LONG TSPIAPI TSPI_phoneGetID(
HDRVPHONE hdPhone,
LPVARSTRING lpDeviceID,
LPCWSTR lpszDeviceClass,
HANDLE hTargetProcess
);
Параметры
hdPhone
Дескриптор запрашиваемого телефона.
lpDeviceID
Указатель на структуру данных типа VARSTRING , в которой возвращается идентификатор устройства. Формат возвращаемых сведений зависит от метода, используемого классом устройства (API) для именования устройств. Перед вызовом TSPI_phoneGetID приложение задает элемент dwTotalSize этой структуры, чтобы указать объем памяти, доступной TAPI для возврата сведений.
lpszDeviceClass
Указатель на строку Юникода, завершающуюся значением NULL, которая указывает класс устройства, идентификатор которого запрашивается.
hTargetProcess
Дескриптор процесса приложения, от имени которого вызывается функция TSPI_phoneGetID . Если данные, возвращаемые в структуре VARSTRING , включают дескриптор для использования приложением, поставщик услуг создает или дублирует дескриптор для процесса.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM PHONEERR_OPERATIONUNAVAIL.
Комментарии
Эта операция может использоваться для получения идентификатора телефонного устройства с использованием дескриптора телефона. Его также можно использовать для получения идентификатора устройства мультимедиа (для классов устройств, таких как COM, wave, MIDI, phone, line и mciwave), связанных с открытым телефонным устройством. Затем этот идентификатор можно использовать с соответствующим API мультимедиа (например, mci, midi и wav) для выбора соответствующего устройства. Дополнительные сведения о распространенных именах классов устройств см. в разделе Классы устройств TSPI.
Поставщик услуг заполняет все элементы структуры данных VARSTRING , за исключением dwTotalSize, которая заполняется с помощью TAPI. Поставщик услуг не должен перезаписывать член dwTotalSize .
Поставщику услуг не нужно заниматься обработкой классов устройств tapi/line и tapi/phone, так как TAPI обрабатывает их для поставщика услуг. Поэтому код для обработки этих классов устройств является необязательным.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |