Поделиться через


IPacket

Обновлен: Ноябрь 2007

Содержит данные и используется объектами, которые реализуют методы интерфейса IDevicePacketStream для передачи данных между приложением агента устройства и настольным компьютером.

IPacket : public IUnknown

Методы

Метод

Описание

IPacket::get_Count

Получает общее число объектов данных в пакете.

IPacket::IsEndOfPacket

Проверяет, достиг ли внутренний итератор конца пакета.

IPacket::ReadBool

Считывает логическое значение из объекта и указывает внутреннему итератору на следующий объект данных в пакете.

IPacket::ReadByte

Считывает байт из объекта и указывает внутреннему итератору на следующий объект данных в пакете.

IPacket::ReadBytes

Считывает массив байтов из объекта и указывает внутреннему итератору на следующий объект данных в пакете.

IPacket::ReadInt32

Считывает целое число из объекта и указывает внутреннему итератору на следующий объект данных в пакете.

IPacket::ReadChar

Считывает символ из объекта и указывает внутреннему итератору на следующий объект данных в пакете.

IPacket::ReadDataType

Возвращает тип данных текущего объекта в пакете в качестве значения перечисления.

IPacket::ReadString

Считывает строку из объекта и указывает внутреннему итератору на следующий объект данных в пакете.

IPacket::Reset

Переустанавливает для внутреннего итератора пакета позицию, в которой он указывает на первый объект данных в пакете. Во время следующей операции чтения считывается первый объект данных в пакете.

IPacket::WriteBool

Записывает логическое значение в объект.

IPacket::WriteByte

Записывает байт в объект.

IPacket::WriteBytes

Записывает массив байтов в объект.

IPacket::WriteChar

Записывает символ в объект.

IPacket::WriteInt32

Записывает целое число в объект.

IPacket::WriteString

Записывает строку в объект.

Заметки

Для получения объекта, реализующего данный интерфейс, используется метод GetNewPacket.

Объекты, реализующие этот интерфейс могут содержать только объекты типа byte, byte[], string, int и char. Интерфейс нельзя расширить для чтения и записи пользовательских объектов. Однако пользователи могут по-прежнему передавать пользовательские объекты через поток либо посредством разбиения пользовательского типа данных на базовые типы данных, либо посредством сериализации пользовательских типов данных в массив байтов.

Пример

Следующий пример — это приложение агента устройства, которое передает один пакет настольному компьютеру и считывает один пакет с настольного компьютера.

#include "stdafx.h"

// Custom implementation of IAgentTransportShutdownCallback
class MyShutdownCallback: public IAgentTransportShutdownCallback
{
private:
    long ref;
public:
    HRESULT STDMETHODCALLTYPE Shutdown(IUnknown *in_pUnknown) 
    {
        // Add your cleanup code here 
        MessageBox(NULL,_T("conmanclient2 exited"),_T("conmanclient exited"),0);
        return 0;
    }

    // Must implement members from IUnknown
    HRESULT STDMETHODCALLTYPE QueryInterface( REFIID riid, void __RPC_FAR *__RPC_FAR *ppvObject)
    {
        return 0;
    }
    ULONG STDMETHODCALLTYPE AddRef( void)
    {
        return InterlockedIncrement(&ref);
    }

    ULONG STDMETHODCALLTYPE Release( void)
    {
        if(InterlockedDecrement(&ref) == 0)
        {
            delete this;
            return 0;
        }
        return ref;
    }
};

int _tmain(int argc, _TCHAR* argv[])
{
    // Load the Device Agent Transport Library
    HINSTANCE hmod;
    hmod = LoadLibrary(L"DeviceAgentTransport.dll");

    // Get an instance of IDeviceAgentTransport
    GetDeviceAgentTransportFunc f1 = (GetDeviceAgentTransportFunc)
        ::GetProcAddress(hmod, L"GetDeviceAgentTransport");
    IDeviceAgentTransport *pTransport = NULL;
    f1(&pTransport);

    // Register the callback with the Device Agent Transport
    MyShutdownCallback *shutdownCallback = new MyShutdownCallback();
    pTransport->RegisterShutdownCallback(shutdownCallback,shutdownCallback);

    // Let the desktop application know that this remote agent was deployed successfully 
    // and that this remote agent will handle the supplied list of services.
    LPCOLESTR szServiceIds[] = {L"F85E57BA-5AE9-4FF7-8433-6AB7D991D033"};
    pTransport->AcknowledgeLaunch(1, szServiceIds);

    // Open a communcation stream with desktop application on the service.
    IDevicePacketStream *pStream = NULL;
    pTransport->AcceptConnectionEx(szServiceIds[0], &pStream);

    // Get an instance of IPacket
    GetNewPacketFunc f2 = (GetNewPacketFunc) ::  GetProcAddress(hmod, L"GetNewPacket");
    IPacket *pPacket = NULL;
    f2(&pPacket);

    // Write a message and sent the packet.
    pPacket->WriteBool(true);
    pPacket->WriteByte(0xff);
    pPacket->WriteChar('c');
    pPacket->WriteInt32(1024);
    pPacket->WriteString(L"Hello Desktop Computer");
    pStream->Write(pPacket);

    // Check for a packet while communication stream is connected.
    f2(&pPacket);
    VARIANT_BOOL connected;
    pStream->IsConnected(&connected);
    while(connected)
    {
        pStream->IsConnected(&connected);
        VARIANT_BOOL available;

        // If a packet is found, display the string.
        pStream->IsPacketAvailable(&available);
        if(available)
        {
            pStream->Read(&pPacket);
            VARIANT_BOOL endofpacket;
            pPacket->IsEndOfPacket(&endofpacket);
            while (!endofpacket) 

            {
                pPacket->IsEndOfPacket(&endofpacket);
                DataTypeEnum datatype;
                pPacket->ReadDataType(&datatype);
                switch (datatype)
                {
                    case DT_BYTE:
                        BYTE byteValue;
                        pPacket->ReadByte(&byteValue);
                        break;
                    case DT_INT32:
                        INT32 intValue;
                        pPacket->ReadInt32(&intValue);
                        break;
                    case DT_WIDECHAR:
                        wchar_t charValue;
                        pPacket->ReadChar(&charValue);
                        break;
                    case DT_BOOL:
                        VARIANT_BOOL boolValue;
                        pPacket->ReadBool(&boolValue);
                        break;
                    case DT_BYTEARRAY:
                        BYTE * buffer[100];
                        ULONG length;
                        pPacket->ReadBytes(buffer,&length);
                        break;
                    case DT_STRING:
                        LPWSTR string;
                        pPacket->ReadString(&string);
                        MessageBox(NULL, string,string,0);
                        break;
                    default:
                        break;
                }
            };
        }
    };
    return 0;
}

Управляемый эквивалент

Microsoft.SmartDevice.DeviceAgentTransport.IPacket

Требования

DeviceAgentTransport.h

См. также

Другие ресурсы

Неуправляемый интерфейс API подключения смарт-устройства, расположенный на стороне устройства