OID_WDI_TASK_P2P_SEND_REQUEST_ACTION_FRAME

Article
03/14/2023

Important

This topic is part of the WDI driver model released in Windows 10. The WDI driver model is in maintenance mode and will only receive high priority fixes. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features.

OID_WDI_TASK_P2P_SEND_REQUEST_ACTION_FRAME is issued to the device to send a Wi-Fi Direct Public Action Frame Request.

Object	Abort capable	Default priority (host driver policy)	Normal execution time (seconds)
Port	Yes. The port must be in a clean state after the abort.	3	5

This command is different than OID_WDI_TASK_P2P_SEND_RESPONSE_ACTION_FRAME, which is a significantly more time-sensitive operation.

When the device receives an acknowledgment for a request frame, it shall dwell on the same channel for 100ms and indicate any Wi-Fi Direct Public Action Frames it receives to the host.

While the maximum timeout has not expired, the device shall retry sending the Wi-Fi Direct Public Action frame to the remote device on the remote device’s listen channel.

The task is complete either when the local device receives an acknowledgment from the remote device for the action frame that was sent, the timeout expires, or the host aborts the operation. The device may indicate task completion after the same-channel dwell time has expired.

The host may decide to abort this operation and continue/retry the Wi-Fi Direct action frame exchange, so it is important that the device is able to abort this operation quickly.

Validation

For miniport drivers that support WDI version 1.1.8 and later, additional validation of the P2P IEs on outgoing P2P Action Frames has been added. This validation addresses a common problem in which the Configuration Timeout attribute of the P2P IE has not been converted form units of milliseconds, as provided to the LE in OID_WDI_TASK_P2P_SEND_REQUEST_ACTION_FRAME and OID_WDI_TASK_P2P_SEND_RESPONSE_ACTION_FRAME, to units of tens of milliseconds, which is the IE format.

The Wi-Fi Direct and Wi-Fi Direct Services HLK tests will fail for drivers supporting WDI version 1.1.8 and later if the Configuration Timeout attribute of the P2P IE is not encoded correctly on an outgoing action frame. For WDI versions 1.1.7 and earlier, the tests will print a warning to the test output.

The WDI interface itself is unchanged and continues to use units of milliseconds just as it did in versions 1.1.7 and earlier.

Task parameters

TLV	Optional	Description
WDI_TLV_P2P_SEND_ACTION_ REQUEST_FRAME_PARAMETERS		Parameters such as action frame type, device address of target peer adapter, and dialog token.
WDI_TLV_P2P_GO_ NEGOTIATION_REQUEST_INFO	X	GO Negotiation Request Parameters. THe port shall only examine this structure if wfdRequestFrameType is a GO Negotiation request.
WDI_TLV_P2P_INVITATION_REQUEST_INFO	X	Invitation Request Parameters. The port shall only examine this structure if wfdRequestFrameType is an Invitation request.
WDI_TLV_P2P_PROVISION_ DISCOVERY_REQUEST_INFO	X	Provision Discovery Request Parameters. The port shall only examine this structure if wfdRequestFrameType is a Provision Discovery request.
WDI_TLV_BSS_ENTRY		The device discovery entry as returned by the Wi-Fi Direct Discovery task from the port. This is provided so the port does not need to remember its discovery database in order to send Wi-Fi Direct Action Frame Requests to remote Wi-Fi Direct devices without requiring a discovery.
WDI_TLV_VENDOR_SPECIFIC_IE	X	One or more IEs that must be included in the frame sent by the port.

Task completion indication

NDIS_STATUS_WDI_INDICATION_P2P_SEND_REQUEST_ACTION_FRAME_COMPLETE

Requirements

Minimum supported client	Windows 10
Minimum supported server	Windows Server 2016
Header	Dot11wdi.h