Função phoneGetID (tapi.h)
A função phoneGetID retorna um identificador de dispositivo para a classe de dispositivo especificada associada ao dispositivo de telefone especificado.
Sintaxe
LONG phoneGetID(
HPHONE hPhone,
LPVARSTRING lpDeviceID,
LPCSTR lpszDeviceClass
);
Parâmetros
hPhone
Identificador para um dispositivo de telefone aberto.
lpDeviceID
Ponteiro para uma estrutura de dados do tipo VARSTRING em que o identificador do dispositivo é retornado. Após a conclusão bem-sucedida da solicitação, esse local é preenchido com o identificador do dispositivo. O formato das informações retornadas depende do método usado pela API (classe de dispositivo) para nomear dispositivos.
lpszDeviceClass
Ponteiro para uma cadeia de caracteres terminada em nulo que especifica a classe de dispositivo do dispositivo cujo identificador é solicitado. Cadeias de caracteres de classe de dispositivo válidas são aquelas usadas na seção System.ini para identificar classes de dispositivo.
Retornar valor
Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:
PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL.
Comentários
A função phoneGetID pode ser usada para recuperar um identificador de dispositivo de telefone dado um identificador de telefone. Ele também pode ser usado para obter o identificador de dispositivo do dispositivo de mídia (para classes de dispositivo como COM, wave, MIDI, telefone, linha ou NDIS) associado ao dispositivo de telefone aberto. Os nomes dessas classes de dispositivo não diferenciam maiúsculas de minúsculas. Esse identificador pode ser usado com a API de mídia apropriada para selecionar o dispositivo correspondente.
Consulte Classes de dispositivo TAPI para obter nomes de classe de dispositivo.
Um fornecedor que define um tipo de mídia específico do dispositivo também precisa definir a API (proprietária) específica do dispositivo correspondente para gerenciar dispositivos do tipo de mídia. Para evitar colisões em nomes de classe de dispositivo atribuídos independentemente por diferentes fornecedores, um fornecedor deve selecionar um nome que identifique exclusivamente o fornecedor e, seguindo-o, o tipo de mídia. Por exemplo: "intel/video".
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |
Confira também
Funções complementares do Serviço de Telefonia