Função lineGetIDA (tapi.h)

A função lineGetID retorna um identificador de dispositivo para a classe de dispositivo especificada associada à linha, endereço ou chamada selecionada.

Sintaxe

LONG lineGetIDA(
  HLINE       hLine,
  DWORD       dwAddressID,
  HCALL       hCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Parâmetros

hLine

Manipule para um dispositivo de linha aberta.

dwAddressID

Endereço no dispositivo de linha aberta especificado. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante em atualizações do sistema operacional.

hCall

Manipule para uma chamada.

dwSelect

Especifica se o identificador de dispositivo solicitado está associado à linha, ao endereço ou a uma única chamada. Esse parâmetro usa uma e apenas uma das constantes LINECALLSELECT_.

lpDeviceID

Ponteiro para um local de memória 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 de classe de dispositivo para nomear dispositivos. Antes de chamar lineGetID, o aplicativo deve definir o dwTotalSize membro dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Observação Se os parâmetros de tamanho na estrutura não estiverem corretos, há a possibilidade de que os dados possam ser substituídos. Para obter mais informações sobre como definir tamanhos de estrutura, consulte o tópico alocação de memória.

 

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 no SYSTEM. Seção INI para identificar classes de dispositivo.

Valor de retorno

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

LINEERR_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODEVICE, LINEERR_UNINITIALIZED.

Observações

A função lineGetID pode ser usada para recuperar um identificador de dispositivo de linha quando determinado identificador de linha. Isso é útil depois que lineOpen foi aberto usando LINEMAPPER como um identificador de dispositivo para determinar o identificador real do dispositivo de linha da linha aberta. Essa função também pode ser usada para obter o identificador de dispositivo de um dispositivo de telefone ou dispositivo de mídia (para classes de dispositivo como COM, wave, MIDI, telefone, linha ou NDIS) associado a uma chamada, endereço ou linha. Esse identificador pode ser usado com a API apropriada (como telefone, MIDI, wave) para selecionar o dispositivo de mídia correspondente associado à chamada especificada.

Consulte de classes de dispositivo TAPI para obter nomes de classe de dispositivo.

Um fornecedor que define um modo de mídia específico do dispositivo também precisa definir a API (proprietária) específica do dispositivo correspondente para gerenciar dispositivos do modo de mídia. Para evitar colisões em nomes de classe de dispositivo atribuídos independentemente por fornecedores diferentes, um fornecedor deve selecionar um nome que identifique exclusivamente o fornecedor e, seguindo-o, o tipo de mídia. Por exemplo: "intel/video".

Nota

O cabeçalho tapi.h define lineGetID como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	tapi.h
biblioteca	Tapi32.lib
de DLL	Tapi32.dll

Consulte também

Referência dos Serviços básicos de telefonia

visão geral de referência do TAPI 2.2

VARSTRING

lineOpen