função TSPI_phoneGetData (tspi.h)
A função TSPI_phoneGetData carrega as informações do local especificado no dispositivo de telefone aberto para o buffer especificado.
Sintaxe
LONG TSPIAPI TSPI_phoneGetData(
HDRVPHONE hdPhone,
DWORD dwDataID,
LPVOID lpData,
DWORD dwSize
);
Parâmetros
hdPhone
O identificador para o telefone a ser consultado.
dwDataID
Especifica de onde no dispositivo de telefone o buffer deve ser carregado.
lpData
Um ponteiro para o buffer de memória no qual os dados devem ser carregados.
dwSize
O tamanho do buffer de dados em bytes. Se o parâmetro lpData for um ponteiro para uma cadeia de caracteres, o tamanho deverá incluir o terminador nulo .
Retornar valor
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL.
Comentários
A função TSPI_phoneGetData carrega um máximo de dwSize bytes do dispositivo de telefone para lpData. Se dwSize for zero, nada será copiado. O tamanho de cada área de dados é listado na estrutura PHONECAPS do telefone.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |