CHANNEL_PDU_HEADER (Windows Embedded CE 6.0)

1/6/2010

This structure contains information about a data block being received by the server end of a virtual channel.

Syntax

typedef struct tagCHANNEL_PDU_HEADER {
  UINT32 length;
  UINT32 flags;
} CHANNEL_PDU_HEADER, *PCHANNEL_PDU_HEADER;

Members

• length
  Size, in bytes, of the data block, excluding this header.

• flags
  Information about the data block. The following table shows the bit flags that are set. Do not make direct comparisons using the == operator; use the methods described in this table to compare the corresponding flag value.

  Value	Description
  CHANNEL_FLAG_FIRST	The chunk is the beginning of the data written by a single write operation. Use bitwise comparisons when comparing this flag.
  CHANNEL_FLAG_LAST	The chunk is the end of the data written by a single write operation. Use bitwise comparisons when comparing this flag.
  CHANNEL_FLAG_MIDDLE	This is the default. The chunk is in the middle of a block of data written by a single write operation. Do not use bitwise comparisons to compare this flag value directly. Instead, use bitwise comparisons to determine that the flag value is not CHANNEL_FLAG_FIRST or CHANNEL_FLAG_LAST. This is done by using the following comparison: Result = !(flags & CHANNEL_FLAG_FIRST) && !(flags & CHANNEL_FLAG_LAST).
  CHANNEL_FLAG_ONLY	Combines the CHANNEL_FLAG_FIRST and CHANNEL_FLAG_LAST values. The chunk contains all the data from a single write operation. Use bitwise comparisons when comparing this flag.

Remarks

This structure is used if the client DLL sets the CHANNEL_OPTION_SHOW_PROTOCOL option when it calls VirtualChannelInit to initialize the virtual channel. If this option is set, a CHANNEL_PDU_HEADER structure is placed at the beginning of each chunk of data read by a call to the WTSVirtualChannelRead function.

Requirements

See Also

Reference

RDP Structures