/*
This file is part of PacketDotNet
PacketDotNet is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
PacketDotNet is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with PacketDotNet. If not, see .
*/
/*
* Copyright 2012 Alan Rushforth
*/
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using PacketDotNet.Utils;
using System.Net.NetworkInformation;
namespace PacketDotNet
{
namespace Ieee80211
{
#region Action Category Enums
//The following enums define the category and type of action. At present these are
//not handled and parsed but they are left here for future reference as tracking them down
//was not that easy
//enum ActionCategory
//{
// SpectrumManagement = 0x0,
// Qos = 0x1,
// Dls = 0x2,
// BlockAck = 0x3,
// VendorSpecific = 0x127
//}
//enum SpectrumManagementAction
//{
// MeasurementRequest = 0x0,
// MeasurementReport = 0x1,
// TpcRequest = 0x2,
// TpcReport = 0x3,
// ChannelSwitchAnnouncement = 0x4
//}
//enum QosAction
//{
// TrafficSpecificationRequest = 0x0,
// TrafficSpecificationResponse = 0x1,
// TrafficSpecificationDelete = 0x2,
// Schedule = 0x3
//}
//enum DlsAction
//{
// DlsRequest = 0x0,
// DlsResponse = 0x1,
// DlsTeardown = 0x2
//}
//enum BlockAcknowledgmentActions
//{
// BlockAcknowledgmentRequest = 0x0,
// BlockAcknowledgmentResponse = 0x1,
// BlockAcknowledgmentDelete = 0x2
//}
#endregion
///
/// Format of an 802.11 management action frame. These frames are used by the 802.11e (QoS) and 802.11n standards to request actions of stations.
///
public class ActionFrame : ManagementFrame
{
///
/// Gets the size of the frame in bytes
///
///
/// The size of the frame.
///
public override int FrameSize
{
get
{
return (MacFields.FrameControlLength +
MacFields.DurationIDLength +
(MacFields.AddressLength * 3) +
MacFields.SequenceControlLength);
}
}
///
/// Constructor
///
///
/// A
///
public ActionFrame (ByteArraySegment bas)
{
header = new ByteArraySegment (bas);
FrameControl = new FrameControlField (FrameControlBytes);
Duration = new DurationField (DurationBytes);
DestinationAddress = GetAddress (0);
SourceAddress = GetAddress (1);
BssId = GetAddress (2);
SequenceControl = new SequenceControlField (SequenceControlBytes);
header.Length = FrameSize;
var availablePayloadLength = GetAvailablePayloadLength();
if(availablePayloadLength > 0)
{
payloadPacketOrData.TheByteArraySegment = header.EncapsulatedBytes (availablePayloadLength);
}
}
///
/// Initializes a new instance of the class.
///
///
/// Source address.
///
///
/// Destination address.
///
///
/// Bss identifier.
///
public ActionFrame (PhysicalAddress SourceAddress,
PhysicalAddress DestinationAddress,
PhysicalAddress BssId)
{
this.FrameControl = new FrameControlField ();
this.Duration = new DurationField ();
this.DestinationAddress = DestinationAddress;
this.SourceAddress = SourceAddress;
this.BssId = BssId;
this.SequenceControl = new SequenceControlField ();
this.FrameControl.SubType = FrameControlField.FrameSubTypes.ManagementAction;
}
///
/// Writes the current packet properties to the backing ByteArraySegment.
///
public override void UpdateCalculatedValues ()
{
if ((header == null) || (header.Length > (header.BytesLength - header.Offset)) || (header.Length < FrameSize))
{
header = new ByteArraySegment (new Byte[FrameSize]);
}
this.FrameControlBytes = this.FrameControl.Field;
this.DurationBytes = this.Duration.Field;
SetAddress (0, DestinationAddress);
SetAddress (1, SourceAddress);
SetAddress (2, BssId);
this.SequenceControlBytes = this.SequenceControl.Field;
}
}
}
}