Compartilhar via


função TSPI_phoneSetData (tspi.h)

A função TSPI_phoneSetData baixa as informações no buffer especificado para o dispositivo de telefone aberto no identificador de dados selecionado.

Sintaxe

LONG TSPIAPI TSPI_phoneSetData(
  DRV_REQUESTID dwRequestID,
  HDRVPHONE     hdPhone,
  DWORD         dwDataID,
  LPVOID const  lpData,
  DWORD         dwSize
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdPhone

O identificador para o telefone no qual os dados devem ser baixados.

dwDataID

Especifica onde, no dispositivo de telefone, o buffer deve ser baixado.

lpData

Um ponteiro para o local de memória do qual os dados devem ser baixados.

dwSize

O tamanho do buffer em bytes. Se o parâmetro lpData for um ponteiro para uma cadeia de caracteres, o tamanho deverá incluir o terminador nulo .

Retornar valor

Retorna dwRequestID ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou se for um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:

PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDATAID, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.

Comentários

A função baixa um máximo de bytes dwSize de lpData para o dispositivo de telefone. O formato dos dados, seu significado para o dispositivo de telefone e o significado do identificador de dados são específicos do provedor de serviços. Os dados no buffer ou a seleção de um identificador de dados podem atuar como comandos para o dispositivo de telefone.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tspi.h

Confira também

ASYNC_COMPLETION

PHONECAPS

TSPI_phoneGetData

TSPI_phoneGetDevCaps