Compartilhar via


Função phoneGetData (tapi.h)

A função phoneGetData carrega as informações do local especificado no dispositivo de telefone aberto para o buffer especificado.

Sintaxe

LONG phoneGetData(
  HPHONE hPhone,
  DWORD  dwDataID,
  LPVOID lpData,
  DWORD  dwSize
);

Parâmetros

hPhone

Identificador para o dispositivo de telefone aberto.

dwDataID

De onde no dispositivo de telefone o buffer deve ser carregado.

lpData

Ponteiro para o buffer de memória em que os dados devem ser carregados.

dwSize

Tamanho do buffer de dados, em bytes.

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_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDATAID, PHONEERR_UNINITIALIZED PHONEERR_OPERATIONUNAVAIL.

Comentários

A função carrega um máximo de dwSize bytes do dispositivo de telefone para a área de memória apontada por lpData. Se dwSize for zero, nada será copiado. O tamanho de cada área de dados é listado nos recursos do dispositivo do telefone.

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

Visão geral da referência do TAPI 2.2