OID_DOT11_WFD_SEND_GO_NEGOTIATION_REQUEST

  • Article

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