SerialDevice Classe

Definição

public ref class SerialDevice sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SerialDevice final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SerialDevice : System.IDisposable

Public NotInheritable Class SerialDevice
Implements IDisposable

Herança

Object Platform::Object IInspectable SerialDevice

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IClosable IDisposable

Requisitos do Windows

Exemplos

using System;
using Windows.Devices.Enumeration;
using Windows.Devices.SerialCommunication;
using Windows.Storage.Streams;

...

DeviceInformationCollection serialDeviceInfos = await DeviceInformation.FindAllAsync(SerialDevice.GetDeviceSelector());

foreach (DeviceInformation serialDeviceInfo in serialDeviceInfos)
{
    try
    {
        SerialDevice serialDevice = await SerialDevice.FromIdAsync(serialDeviceInfo.Id);

        if (serialDevice != null)
        {
            // Found a valid serial device.

            // Reading a byte from the serial device.
            DataReader dr = new DataReader(serialDevice.InputStream);
            int readByte = dr.ReadByte();

            // Writing a byte to the serial device.
            DataWriter dw = new DataWriter(serialDevice.OutputStream);
            dw.WriteByte(0x42);
        }
    }
    catch (Exception)
    {
        // Couldn't instantiate the device
    }
}

Comentários

A funcionalidade do dispositivo serial, serialCommunication, é necessária para usar a SerialDevice classe . Para obter mais informações, consulte Windows.Devices.SerialCommunication.

Criar um objeto SerialDevice

1. Gere uma cadeia de caracteres AQS (Sintaxe de Consulta Avançada) que contém critérios de pesquisa para localizar o dispositivo na coleção de dispositivos enumerados. Se você tiver os identificadores de fornecedor e produto, chame GetDeviceSelectorFromUsbVidPid.
2. Passe a cadeia de caracteres recuperada para FindAllAsync. A chamada recupera um objeto DeviceInformationCollection .
3. Execute um loop pela coleção. Cada iteração obtém um objeto DeviceInformation .
4. Obtenha o valor da propriedade DeviceInformation.Id . O valor da cadeia de caracteres é o caminho da interface do dispositivo. (por exemplo \\?\usb#vid_03eb&pid_2157&mi_01#7&1435ec7f&0&0001#{86e0d1e0-8089-11d0-9ce4-08003e301f73}, ).
5. Chame FromIdAsync passando a cadeia de caracteres da interface do dispositivo e obtenha o SerialDevice objeto . Se isso gerar uma exceção ou retornar nulo, provavelmente será:
   • O caminho da interface do dispositivo é inválido
   • O caminho da interface do dispositivo não representa novamente um dispositivo serial
   • O aplicativo não tem a serialCommunication funcionalidade
   • O dispositivo serial está inacessível. (consulte Windows.Devices.SerialCommunication)

Dados de leitura e gravação

Em seguida, você pode usar o objeto SerialDevice para ler ou gravar na porta serial usando o namespace Windows.Storage.Streams .

1. Obtenha uma referência ao fluxo de entrada obtendo a propriedade SerialDevice.InputStream .
2. Crie um objeto DataReader especificando o fluxo de entrada no construtor DataReader .
3. Obtenha uma referência ao fluxo de saída obtendo a propriedade SerialDevice.OutputStream .
4. Crie um objeto DataWriter especificando o fluxo de saída no construtor DataWriter .

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• Exemplo de dispositivo serial personalizado
• Exemplo de arduino serial