IPacket
Обновлен: Ноябрь 2007
Содержит данные и используется объектами, которые реализуют методы интерфейса IDevicePacketStream для передачи данных между приложением агента устройства и настольным компьютером.
IPacket : public IUnknown
Методы
Метод |
Описание |
---|---|
Получает общее число объектов данных в пакете. |
|
Проверяет, достиг ли внутренний итератор конца пакета. |
|
Считывает логическое значение из объекта и указывает внутреннему итератору на следующий объект данных в пакете. |
|
Считывает байт из объекта и указывает внутреннему итератору на следующий объект данных в пакете. |
|
Считывает массив байтов из объекта и указывает внутреннему итератору на следующий объект данных в пакете. |
|
Считывает целое число из объекта и указывает внутреннему итератору на следующий объект данных в пакете. |
|
Считывает символ из объекта и указывает внутреннему итератору на следующий объект данных в пакете. |
|
Возвращает тип данных текущего объекта в пакете в качестве значения перечисления. |
|
Считывает строку из объекта и указывает внутреннему итератору на следующий объект данных в пакете. |
|
Переустанавливает для внутреннего итератора пакета позицию, в которой он указывает на первый объект данных в пакете. Во время следующей операции чтения считывается первый объект данных в пакете. |
|
Записывает логическое значение в объект. |
|
Записывает байт в объект. |
|
Записывает массив байтов в объект. |
|
Записывает символ в объект. |
|
Записывает целое число в объект. |
|
Записывает строку в объект. |
Заметки
Для получения объекта, реализующего данный интерфейс, используется метод 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 подключения смарт-устройства, расположенный на стороне устройства