Location Channel

Location channel providing redirection of client side Network/GPS location to the RDP server. More...

Data Structures
struct	RDPLOCATION_HEADER
struct	RDPLOCATION_SERVER_READY_PDU
struct	RDPLOCATION_CLIENT_READY_PDU
struct	RDPLOCATION_BASE_LOCATION3D_PDU
struct	RDPLOCATION_LOCATION2D_DELTA_PDU
struct	RDPLOCATION_LOCATION3D_DELTA_PDU

Macros
#define	LOCATION_CHANNEL_NAME   "location" /** @since version 3.4.0 */
#define	LOCATION_DVC_CHANNEL_NAME   "Microsoft::Windows::RDS::Location"
#define	LOCATION_HEADER_SIZE   6

Enumerations
enum	LOCATION_PDUTYPE {   PDUTYPE_LOC_RESERVED = 0x0000 , PDUTYPE_SERVER_READY = 0x0001 , PDUTYPE_CLIENT_READY = 0x0002 , PDUTYPE_BASE_LOCATION3D = 0x0003 ,   PDUTYPE_LOCATION2D_DELTA = 0x0004 , PDUTYPE_LOCATION3D_DELTA = 0x0005 }
enum	RDPLOCATION_PROTOCOL_VERSION { RDPLOCATION_PROTOCOL_VERSION_100 = 0x00010000 , RDPLOCATION_PROTOCOL_VERSION_200 = 0x00020000 }
enum	LOCATIONSOURCE { LOCATIONSOURCE_IP = 0x00 , LOCATIONSOURCE_WIFI = 0x01 , LOCATIONSOURCE_CELL = 0x02 , LOCATIONSOURCE_GNSS = 0x03 }

Detailed Description

Location channel providing redirection of client side Network/GPS location to the RDP server.

FreeRDP: A Remote Desktop Protocol Implementation Location Virtual Channel Extension

Copyright 2023 Pascal Nowack Pasca.nosp@m.l.No.nosp@m.wack@.nosp@m.gmx..nosp@m.de

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

---

Data Structure Documentation

RDPLOCATION_HEADER

struct RDPLOCATION_HEADER

Definition at line 58 of file channels/location.h.

Data Fields
UINT32	pduLength
LOCATION_PDUTYPE	pduType

RDPLOCATION_SERVER_READY_PDU

struct RDPLOCATION_SERVER_READY_PDU

Definition at line 70 of file channels/location.h.

Collaboration diagram for RDPLOCATION_SERVER_READY_PDU:

Data Fields
UINT32	flags
RDPLOCATION_HEADER	header
RDPLOCATION_PROTOCOL_VERSION	protocolVersion

RDPLOCATION_CLIENT_READY_PDU

struct RDPLOCATION_CLIENT_READY_PDU

Definition at line 77 of file channels/location.h.

Collaboration diagram for RDPLOCATION_CLIENT_READY_PDU:

Data Fields
UINT32	flags
RDPLOCATION_HEADER	header
RDPLOCATION_PROTOCOL_VERSION	protocolVersion

RDPLOCATION_BASE_LOCATION3D_PDU

struct RDPLOCATION_BASE_LOCATION3D_PDU

Definition at line 92 of file channels/location.h.

Collaboration diagram for RDPLOCATION_BASE_LOCATION3D_PDU:

Data Fields
INT32	altitude
RDPLOCATION_HEADER	header
double *	heading
double *	horizontalAccuracy
double	latitude
double	longitude
LOCATIONSOURCE *	source
double *	speed

RDPLOCATION_LOCATION2D_DELTA_PDU

struct RDPLOCATION_LOCATION2D_DELTA_PDU

Definition at line 104 of file channels/location.h.

Collaboration diagram for RDPLOCATION_LOCATION2D_DELTA_PDU:

Data Fields
RDPLOCATION_HEADER	header
double *	headingDelta
double	latitudeDelta
double	longitudeDelta
double *	speedDelta

RDPLOCATION_LOCATION3D_DELTA_PDU

struct RDPLOCATION_LOCATION3D_DELTA_PDU

Definition at line 113 of file channels/location.h.

Collaboration diagram for RDPLOCATION_LOCATION3D_DELTA_PDU:

Data Fields
INT32	altitudeDelta
RDPLOCATION_HEADER	header
double *	headingDelta
double	latitudeDelta
double	longitudeDelta
double *	speedDelta

Macro Definition Documentation

LOCATION_CHANNEL_NAME

#define LOCATION_CHANNEL_NAME   "location" /** @since version 3.4.0 */

The command line name of the channel

Since

version 3.0.0

Definition at line 37 of file channels/location.h.

LOCATION_DVC_CHANNEL_NAME

#define LOCATION_DVC_CHANNEL_NAME   "Microsoft::Windows::RDS::Location"

Definition at line 39 of file channels/location.h.

LOCATION_HEADER_SIZE

#define LOCATION_HEADER_SIZE   6

Definition at line 56 of file channels/location.h.

Enumeration Type Documentation

LOCATION_PDUTYPE

enum LOCATION_PDUTYPE

Definition at line 46 of file channels/location.h.

  {
    PDUTYPE_LOC_RESERVED = 0x0000,
    PDUTYPE_SERVER_READY = 0x0001,
    PDUTYPE_CLIENT_READY = 0x0002,
    PDUTYPE_BASE_LOCATION3D = 0x0003,
    PDUTYPE_LOCATION2D_DELTA = 0x0004,
    PDUTYPE_LOCATION3D_DELTA = 0x0005,
  } LOCATION_PDUTYPE;

LOCATIONSOURCE

enum LOCATIONSOURCE

Definition at line 84 of file channels/location.h.

  {
    LOCATIONSOURCE_IP = 0x00,
    LOCATIONSOURCE_WIFI = 0x01,
    LOCATIONSOURCE_CELL = 0x02,
    LOCATIONSOURCE_GNSS = 0x03,
  } LOCATIONSOURCE;

RDPLOCATION_PROTOCOL_VERSION

enum RDPLOCATION_PROTOCOL_VERSION

Definition at line 64 of file channels/location.h.

  {
    RDPLOCATION_PROTOCOL_VERSION_100 = 0x00010000,
    RDPLOCATION_PROTOCOL_VERSION_200 = 0x00020000,
  } RDPLOCATION_PROTOCOL_VERSION;