Função lineGetID (tapi.h)

Artigo
08/26/2023

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

Sintaxe

LONG lineGetID(
  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 entre as 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 membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

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

Comentários

A função lineGetID pode ser usada para recuperar um identificador de dispositivo de linha quando determinado um identificador de linha. Isso é útil depois que lineOpen é aberto usando LINEMAPPER como um identificador de dispositivo para determinar o identificador real de 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 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 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".