IPacket

更新：2007 年 11 月

保存由實作 IDevicePacketStream 之物件所使用的資料，以便在裝置代理程式應用程式和桌上型電腦間傳輸資料。

IPacket : public IUnknown

方法

方法	說明
IPacket::get_Count	取得封包中資料物件的總數。
IPacket::IsEndOfPacket	檢查內部 Iterator 是否達到封包的結尾。
IPacket::ReadBool	讀取物件中的布林值，並將內部 Iterator 指向封包中的下一個資料物件。
IPacket::ReadByte	讀取物件中的位元組，並將內部 Iterator 指向封包中的下一個資料物件。
IPacket::ReadBytes	讀取物件中的位元組陣列，並將內部 Iterator 指向封包中的下一個資料物件。
IPacket::ReadInt32	讀取物件中的整數，並將內部 Iterator 指向封包中的下一個資料物件。
IPacket::ReadChar	讀取物件中的字元，並將內部 Iterator 指向封包中的下一個資料物件。
IPacket::ReadDataType	將封包內目前物件的資料型別當做列舉值傳回。
IPacket::ReadString	讀取物件中的字串，並將內部 Iterator 指向封包中的下一個資料物件。
IPacket::Reset	重設封包的內部 Iterator 以指向封包中的第一個資料物件。下一個讀取作業會讀取封包中的第一個資料物件。
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;
}

Managed 對應項

Microsoft.SmartDevice.DeviceAgentTransport.IPacket

需求

DeviceAgentTransport.h

請參閱

其他資源

Unmanaged 裝置端智慧型裝置連接 API