<mx:SecureDeviceAssociationTemplate> Element

Parameters for a SecureDeviceAssociationTemplate object to instantiate.

Every SecureDeviceAssociationTemplate that exists must have an AllowedUsages child element.

This element is optional.

Syntax

<mx:SecureDeviceAssociationTemplate
  Name = string
  InitiatorSocketDescription = string
  AcceptorSocketDescription = string
  MultiplayerSessionRequirement = string >
</mx:SecureDeviceAssociationTemplate>

Attributes

Name
The name string for the SecureDeviceAssociationTemplate object, corresponding to the result returned by SecureDeviceAssociationTemplate.Name. Must be unique among all SecureDeviceAssociationTemplate nodes. Cannot be an empty string.

InitiatorSocketDescription
The name string for the SecureDeviceSocketDescription object used to initiate SecureDeviceAssociations from this template. This must reference a valid SocketDescription element with the corresponding Name attribute in the network manifest XML.

AcceptorSocketDescription
The name string for the SecureDeviceSocketDescription object used to accept SecureDeviceAssociations from this template. This must reference a valid SocketDescription element with the corresponding Name attribute in the network manifest XML.

MultiplayerSessionRequirement
This attribute is currently ignored.

Element information

Parent elements mx:SecureDeviceAssociationTemplates
Child elements mx:AllowedUsages

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