Função phoneGetID (tapi.h)

Artigo
08/26/2023

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".