Share via


IPacket

Holds data and is used by objects that implement IDevicePacketStream to transfer data between a device agent application and a desktop computer.

IPacket : public IUnknown

Methods

Method

Description

IPacket::get_Count

Gets the total number of data objects in the packet.

IPacket::IsEndOfPacket

Checks if the internal iterator has reached the end of the packet.

IPacket::ReadBool

Reads a Boolean value from the object and points the internal iterator to the next data object in the packet.

IPacket::ReadByte

Reads a byte from the object and points the internal iterator to the next data object in the packet.

IPacket::ReadBytes

Reads an array of bytes from the object and points the internal iterator to the next data object in the packet.

IPacket::ReadInt32

Reads an integer from the object and points the internal iterator to the next data object in the packet.

IPacket::ReadChar

Reads a character from the object and points the internal iterator to the next data object in the packet.

IPacket::ReadDataType

Returns the data type of the current object in the packet as an enumeration value.

IPacket::ReadString

Reads a string from the object and points the internal iterator to the next data object in the packet.

IPacket::Reset

Resets the packet's internal iterator to point to the first data object in the packet. The next read operation reads the first data object in the packet.

IPacket::WriteBool

Writes a Boolean value to the object.

IPacket::WriteByte

Writes a byte to the object.

IPacket::WriteBytes

Writes an array of bytes to the object.

IPacket::WriteChar

Writes a character to the object.

IPacket::WriteInt32

Writes an integer to the object.

IPacket::WriteString

Writes a string to the object.

Remarks

To get an object that implements this interface, use GetNewPacket.

Objects that implement this interface can only hold objects of type byte, byte[], string, int, and char. It is not extensible to read and write custom objects. However, users can still transfer custom objects across the stream by either splitting the custom data type into basic data types or serializing the custom data types into a byte array.

Example

The following example is a device agent application that writes one packet to the desktop and reads one packet from the desktop.

Managed Equivalent

Microsoft.SmartDevice.DeviceAgentTransport..::.IPacket

Requirements

DeviceAgentTransport.h

See Also

Other Resources

Unmanaged Device-Side Smart Device Connectivity API