<div class="content" name="ADAPTER2" uuid="6b19652b-ea18-420e-9971-53d909e70796"><p>The <b>ADAPTER2</b> structure contains information about a
single network adapter on the system.</p><table>
 <tbody><tr>
  <th><p><br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>1<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>2<br/>0</p></th>
  <th><p><br/>1</p></th>
  <th><p><br/>2</p></th>
  <th><p><br/>3</p></th>
  <th><p><br/>4</p></th>
  <th><p><br/>5</p></th>
  <th><p><br/>6</p></th>
  <th><p><br/>7</p></th>
  <th><p><br/>8</p></th>
  <th><p><br/>9</p></th>
  <th><p>3<br/>0</p></th>
  <th><p><br/>1</p></th>
 </tr>
 <tr>
  <td colspan="16">Adapter2IdentifierLength</td>
  <td colspan="16">Adapter2Identifier</td>
 </tr>
 <tr>
  <td colspan="16">DescriptionLength</td>
  <td colspan="16">Description (variable)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="16">FriendlyNameLength</td>
  <td colspan="16">FriendlyName (variable)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="16">NameLength</td>
  <td colspan="16">Name (variable)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="16">NumberOfPrefixes</td>
  <td colspan="16">Prefix (variable)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="16">PhysicalAddressLength</td>
  <td colspan="16">PhysicalAddress (variable)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="16">NumberOfAddresses</td>
  <td colspan="16">Address (128 bytes)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="16">...</td>
  <td colspan="16">NumberOfGatewayAddresses</td>
 </tr>
 <tr>
  <td colspan="32">GatewayAddress (128 bytes)</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="32">InterfaceIndex</td>
 </tr>
 <tr>
  <td colspan="32">AdapterType</td>
 </tr>
 <tr>
  <td colspan="32">TunnelType</td>
 </tr>
 <tr>
  <td colspan="32">OperStatus</td>
 </tr>
 <tr>
  <td colspan="8">DhcpEnabled</td>
  <td colspan="8">InternalNetwork</td>
  <td colspan="8">ClusterAdapter</td>
  <td colspan="8">ConnectedToiSCSI</td>
 </tr>
 <tr>
  <td colspan="32">LinkSpeed</td>
 </tr>
 <tr>
  <td colspan="32">...</td>
 </tr>
 <tr>
  <td colspan="8">RdmaCapable</td>
  <td colspan="8">RssCapable</td>
  
 </tr>
</tbody></table><p><b>Adapter2IdentifierLength (2 bytes): </b>An
unsigned short that MUST be the value 0x0002.</p><p><b>Adapter2Identifier (2 bytes): </b>An unsigned
short that MUST be the value 0x227B.</p><p><b>DescriptionLength (2 bytes): </b>An unsigned short
that MUST contain the size, in bytes, of the <b>Description</b> field.</p><p><b>Description (variable): </b>A user-friendly
description of the adapter, the value of which is implementation-specific. The
string SHOULD be unique within the set of ADAPTER2s in an <span><a href="4d30c933-29d0-44d7-9772-4620ce17f4c2" data-linktype="relative-path">ADAPTERLIST2</a></span>.
This field MUST be a Unicode string without a terminating null character.</p><p><b>FriendlyNameLength (2 bytes): </b>An unsigned
short that MUST contain the size, in bytes, of the <b>FriendlyName</b> field.</p><p><b>FriendlyName (variable): </b>A user-friendly name
to identify the adapter, the value of which is implementation-specific. The
string MUST be unique within the set of ADAPTER2s in an ADAPTERLIST2. This
field MUST be a Unicode string without a terminating null character.</p><p><b>NameLength (2 bytes): </b>An unsigned short that
MUST contain the size, in bytes, of the <b>Name</b> field.</p><p><b>Name (variable): </b>The name that the adapter
identifies itself as, the value of which is implementation-specific. The string
MUST be unique within the set of ADAPTER2s in an ADAPTERLIST2. This field MUST
be a Unicode string without a terminating null character.</p><p><b>NumberOfPrefixes (2 bytes): </b>An unsigned short
that MUST be the number of elements in the <b>Prefix</b> field.</p><p><b>Prefix (variable): </b>This field MUST be a valid <span><a href="80878f99-a962-452e-971e-16ab7b7826ee" data-linktype="relative-path">IPPREFIX</a></span>
structure. Contains the associated prefix lengths for the addresses of the
adapter listed in the <b>Address</b> field.</p><p><b>PhysicalAddressLength (2 bytes): </b>An unsigned
short that MUST contain the size, in bytes, of the <b>PhysicalAddress</b>
field.</p><p><b>PhysicalAddress (variable): </b>This field MUST be
a Unicode string without a terminating null character. The value of the string
is the string representation in hexadecimal of the Media Access Control (MAC)
address of the adapter. If the <b>AdapterType</b> field is
IF_TYPE_ETHERNET_CSMACD (0x00000006), this string MUST be in the form
&#34;AA-BB-CC-DD-EE-FF&#34;, where AA is the 2-byte hexadecimal
representation of the first byte of the MAC address, BB is the 2-byte
representation of the second byte of the MAC address, and continuing in like
fashion to the end of the string, where FF is the 2-byte representation of the
sixth byte of the MAC address. Alphabetic characters (A–F) in the hexadecimal
representations MUST be capitalized. If the <b>AdapterType</b> field is some
value other than IF_TYPE_ETHERNET_CSMACD, then the same form is used. If the
MAC address has fewer than 8 bytes, the server SHOULD treat bytes beyond the
length of the MAC address as 0x00.</p><p><b>NumberOfAddresses (2 bytes): </b>An unsigned short
that MUST be the number of elements in the <b>Address</b> field.</p><p><b>Address (128 bytes): </b>The addresses of the
adapter. This field MUST be laid out as a sockaddr_in or sockaddr_in6 structure
as specified in <span><a href="https://go.microsoft.com/fwlink/?LinkId=90367" data-linktype="external">[RFC2553]</a></span>. The
remaining bytes SHOULD be set to 0x00.</p><p><b>NumberOfGatewayAddresses (2 bytes): </b>An
unsigned short that MUST be the number of elements in the <b>GatewayAddress</b>
field.</p><p><b>GatewayAddress (128 bytes): </b>The addresses of
the network gateway. This field MUST be laid out as a sockaddr_in or
sockaddr_in6 structure as specified in [RFC2553]. The remaining bytes SHOULD be
set to 0x00.</p><p><b>InterfaceIndex (4 bytes): </b>The client MUST
ignore this value.</p><p><b>AdapterType (4 bytes): </b>A constant that
describes the adapter type. This field MUST be one of the values specified by
the Internet Assigned Numbers Authority (IANA) <span><a href="https://go.microsoft.com/fwlink/?LinkId=89884" data-linktype="external">[IANAifType]</a></span>.</p><p><b>TunnelType (4 bytes): </b>A constant that
describes the type of tunnel protocol that the adapter supports. This field
MUST be one of the values defined by the IANA [IANAifType] or 0.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>1 — 15</td>
  <td>A tunnel type defined by IANA [IANAifType].</td>
 </tr><tr>
  <td>TUNNEL_TYPE_NONE 0</td>
  <td>A tunnel type was not specified.</td>
 </tr></tbody></table>
</dd></dl><p><b>OperStatus (4 bytes): </b>A number representing
the status of the adapter. MUST be one of the values defined in <span><a href="https://go.microsoft.com/fwlink/?LinkID=111187" data-linktype="external">[RFC2863]</a></span>.</p><p><b>DhcpEnabled (1 byte): </b>This field MUST be set
to 0x01 if the adapter is enabled for <span><a href="b30bcd1c-8ff6-46d2-a27e-61bd85ace9f4#gt_06dde11c-7929-4f48-a1c7-f48fb71e8341" data-linktype="relative-path">Dynamic Host Configuration
Protocol (DHCP)</a></span>; otherwise, the value MUST be 0x00.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x01</td>
  <td>The adapter is enabled for DHCP.</td>
 </tr><tr>
  <td>0x00</td>
  <td>The adapter is not enabled for DHCP.</td>
 </tr></tbody></table>
</dd></dl><p><b>InternalNetwork (1 byte): </b>This field MUST be
set to 0x01 if the adapter is recommended by the implementation to be suitable
as a private network; otherwise, the value MUST be set to 0x00. A private
network is specified in <span><a href="../ms-cmrp/ba4117c0-530e-4e70-a085-4b4cf5bbf193" data-linktype="relative-path">[MS-CMRP]</a></span>
section <span><a href="../ms-cmrp/30471b21-60a1-42db-b6e5-0fd19dc9b75d" data-linktype="relative-path">3.1.1.7</a></span>.
The algorithm to determine private network suitability is
implementation-specific.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x01</td>
  <td>The adapter is recommended by the implementation to be suitable as a private network.</td>
 </tr><tr>
  <td>0x00</td>
  <td>The adapter is not recommended by the implementation to be suitable as a private network.</td>
 </tr></tbody></table>
</dd></dl><p><b>ClusterAdapter (1 byte): </b>This field MUST be
set to 0x01 if the adapter is determined to be a cluster adapter; otherwise,
the value MUST be set to 0x00. A cluster adapter is a virtual adapter managed
by the cluster software but is not a cluster network interface as specified in
[MS-CMRP]. In a given ADAPTERLIST2, there SHOULD be exactly one ADAPTER2 with <b>ClusterAdapter</b>
set to 0x01.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x01</td>
  <td>The adapter is a cluster adapter.</td>
 </tr><tr>
  <td>0x00</td>
  <td>The adapter is not a cluster adapter.</td>
 </tr></tbody></table>
</dd></dl><p><b>ConnectedToiSCSI (1 byte): </b>This field MUST be
set to 0x01 if the server is configured to use the adapter to fulfill the
Initiator role in the iSCSI protocol.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x01</td>
  <td>The server is configured to use the adapter to fulfill the Initiator role in the iSCSI protocol.</td>
 </tr><tr>
  <td>0x00</td>
  <td>The server is not configured to use the adapter to fulfill the Initiator role in the iSCSI protocol.</td>
 </tr></tbody></table>
</dd></dl><p><b>LinkSpeed (8 bytes): </b>This field MUST be set to
the number of bytes per second the server can transmit and receive using the
adapter.</p><p><b>RdmaCapable (1 byte): </b>This field MUST be set
to 0x01 if the adapter is recommended by the implementation for efficiency in
transfer of large data payloads, such as for Remote Direct Memory Access. The
algorithm by which a server implementation determines whether an adapter is
recommended for efficiency in transfer of large data payloads is
implementation-specific.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x01</td>
  <td>The adapter is recommended by the implementation for efficiency in transfer of large data payloads.</td>
 </tr><tr>
  <td>0x00</td>
  <td>The adapter is not recommended by the implementation for efficiency in transfer of large data payloads.</td>
 </tr></tbody></table>
</dd></dl><p><b>RssCapable (1 byte): </b>This field MUST be set to
0x01 if the adapter is recommended by the implementation for efficiency in
processing received data across multiple processors. The algorithm by which a
server implementation determines whether an adapter is recommended for
efficiency in processing received data across multiple processors is
implementation-specific.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x01</td>
  <td>The adapter is recommended by the implementation for efficiency in processing received data across multiple processors.</td>
 </tr><tr>
  <td>0x00</td>
  <td>The adapter is not recommended by the implementation for efficiency in processing received data across multiple processors.</td>
 </tr></tbody></table>
</dd></dl><p> </p></div>