<mx:AllowedUsages> Element

Allowed usages for a secure device socket or a secure device association template.

Child of SocketDescription

Every SocketDescription element must have one AllowedUsages container element for a collection of one or more SecureDeviceSocketUsage elements.

Note Note that chat and game data usages (ReceiveChat and SendChat, ReceiveGameData and SendGameData) indicate the intention to use secure communications, while the debug usages (ReceiveDebug and SendDebug) indicate the intention to send traffic in the clear. Traffic is not allowed for templates specifying chat or game data usages when no SecureDeviceAssociation is created for that template, regardless of whether debug usage has been specified for the template. Instead, the call to bind fails with error code WSAEACCES.

Child of SecureDeviceAssociationTemplate

Every SecureDeviceAssociationTemplate that exists must have an AllowedUsages child element.

This element is optional.

Syntax

<mx:AllowedUsages >
</mx:AllowedUsages>

Element information

Parent elements mx:SocketDescription, mx:SecureDeviceAssociationTemplate
Child elements mx:SecureDeviceSocketUsage(as child of SocketDescription), mx:SecureDeviceAssociationUsage(as child of SecureDeviceAssociationTemplate)

Example

<mx:Extension Category="windows.xbox.networking">
  <mx:XboxNetworkingManifest>
    <mx:SocketDescriptions>
      <mx:SocketDescription Name="MultiplayerSocketUdp" SecureIpProtocol="Udp" BoundPort="8700">
        <mx:AllowedUsages>
          <mx:SecureDeviceSocketUsage Type="Initiate" />
          <!-- connection will send initial packet -->
          <mx:SecureDeviceSocketUsage Type="Accept" />
          <!-- connection will accept packets -->
          <mx:SecureDeviceSocketUsage Type="SendGameData" />
          <!-- connection will send game data packets (UDP) -->
          <mx:SecureDeviceSocketUsage Type="ReceiveGameData" />
          <!-- connection will receive game data packets (UDP) -->
        </mx:AllowedUsages>
      </mx:SocketDescription>
    </mx:SocketDescriptions>
    <mx:SecureDeviceAssociationTemplates>
      <mx:SecureDeviceAssociationTemplate Name="MultiplayerUdp" InitiatorSocketDescription="MultiplayerSocketUdp" AcceptorSocketDescription="MultiplayerSocketUdp" MultiplayerSessionRequirement="Required">
        <mx:AllowedUsages>
          <mx:SecureDeviceAssociationUsage Type="InitiateFromMicrosoftConsole" />
          <mx:SecureDeviceAssociationUsage Type="AcceptOnMicrosoftConsole" />          
        </mx:AllowedUsages>
      </mx:SecureDeviceAssociationTemplate>
    </mx:SecureDeviceAssociationTemplates>
  </mx:XboxNetworkingManifest>
</mx:Extension>

See also

Specifying the Secure Device Association Templates for your App