OID_DOT11_WFD_SEND_GO_NEGOTIATION_REQUEST

Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.
 

When set, the OID_DOT11_WFD_SEND_GO_NEGOTIATION_REQUEST object identifier (OID) requests that the Wi-Fi Direct (WFD) miniport driver send a Group Owner (GO) negotiation request to a WFD peer currently in device mode.

The data type for OID_DOT11_WFD_SEND_GO_NEGOTIATION_REQUEST is the DOT11_SEND_GO_NEGOTIATION_REQUEST_PARAMETERS structure.



    typedef struct _DOT11_SEND_GO_NEGOTIATION_REQUEST_PARAMETERS {
        NDIS_OBJECT_HEADER Header;
        DOT11_MAC_ADDRESS PeerDeviceAddress;
        DOT11_DIALOG_TOKEN DialogToken;
        ULONG uSendTimeout;
        DOT11_WFD_GO_INTENT GroupOwnerIntent;
        DOT11_WFD_CONFIGURATION_TIMEOUT MinimumConfigTimeout;
        DOT11_MAC_ADDRESS IntendedInterfaceAddress;
        DOT11_WFD_GROUP_CAPABILITY GroupCapability;
        ULONG uIEsOffset;
        ULONG uIEsLength;
    } DOT11_SEND_GO_NEGOTIATION_REQUEST_PARAMETERS, * PDOT11_SEND_GO_NEGOTIATION_REQUEST_PARAMETERS;
  

This structure includes the following members:

Header

The type, revision, and size of the DOT11_SEND_GO_NEGOTIATION_REQUEST_PARAMETERS structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The miniport driver must set the members of Header to the following values:

Type

This member must be set to NDIS_OBJECT_TYPE_DEFAULT.

Revision

This member must be set to DOT11_SEND_GO_NEGOTIATION_REQUEST_PARAMETERS_REVISION_1.

Size

This member must be set to DOT11_SIZEOF_SEND_GO_NEGOTIATION_REQUEST_PARAMETERS_REVISION_1.

For more information about these members, see NDIS_OBJECT_HEADER.

PeerDeviceAddress

The Peer-to-Peer (P2P) address of the Wi-Fi Direct (WFD) device where the GO negotiation request will be sent.

DialogToken

The dialog token to insert in the GO negotiation request packet.

uSendTimeout

The maximum time, in milliseconds, allowed to send the GO negotiation request. If the time-out expires before the miniport has successfully transmitted the GO negotiation request, it should indicate the NDIS_STATUS_DOT11_WFD_GO_NEGOTIATION_REQUEST_SEND_COMPLETE with a failure status.

GroupOwnerIntent

The GO intent value. This value is included in the Group Owner Intent attribute of the GO negotiation request packet.

MinimumConfigTimeout

The configuration time-out, in milliseconds, required by the system to change its mode of operation to Peer-to-Peer (P2P) GO or P2P Client. The miniport driver can overwrite this value with a longer time-out.

IntendedInterfaceAddress

The Intended Interface address to be used for generation of the GO negotiation request.

GroupCapability

The values to set in the Group Capability bitmask of the P2P Capability Information Element (IE) in the GO negotiation request.

uIEsOffset

The offset, in bytes, of the array of additional IEs the Wi-Fi Direct (WFD) port must add to the GO negotiation request packet. This offset is from the start of the buffer that contains this structure.

uIEsLength

The length, in bytes, of the array of IEs provided at uIEsOffset.

When receiving this OID, the miniport must create and populate all the required P2P attributes in the P2P IE prior to sending the GO negotiation request packet.

This OID is sent to the miniport with NdisRequestSetInformation as the OID request type. After creating the packet for transmission, the miniport must complete the OID with NDIS_STATUS_INDICATION_REQUIRED. The completion of the attempt to send the GO negotiation request must be indicated back to the system with an NDIS_STATUS_DOT11_WFD_GO_NEGOTIATION_REQUEST_SEND_COMPLETE indication. The miniport driver must send the NDIS_STATUS_DOT11_WFD_GO_NEGOTIATION_REQUEST_SEND_COMPLETE after stopping the attempt to send the GO negotiation request. This must occur in either case of success or failure.

Miniport drivers should periodically attempt sending the GO Negotiation Request frame at intervals no longer than 50ms because a remote device may not be constantly available on its listen channel.

Requirements

Version

Supported starting with Windows 8.

Header

Windot11.h (include Windot11.h)

See also

NDIS_OBJECT_HEADER
NDIS_STATUS_DOT11_WFD_GO_NEGOTIATION_REQUEST_SEND_COMPLETE

 

 

Send comments about this topic to Microsoft

Show: