OID_WDI_TASK_P2P_DISCOVER
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_DISCOVER is issued to the device to perform Wi-Fi Direct discovery.
| 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. | 6 | 15 |
The command contains properties which define either a specific set of Wi-Fi Direct devices to search for, or wildcard discovery.
Wi-Fi Direct discovery is mutually exclusive from standard Wi-Fi scanning. While this task is running, broadcast probe requests shall not be sent without a "DIRECT-" SSID, or a specific GO SSID. These probe requests must also include all necessary Wi-Fi Direct IEs.
The host may have search criteria which is not provided as part of the task parameters down to the device. The host may use the task abort mechanism if it has matched the required criteria, therefore it is important that the device can abort Wi-Fi Direct Discovery tasks quickly so as not to degrade scenario performance.
When the task has been completed (either normally or due to an abort), the port should be in a good state such that another discover request can be issued on that port.
Task parameters
| TLV | Multiple TLV instances allowed | Optional | Description |
|---|---|---|---|
| WDI_TLV_P2P_DISCOVER_MODE | Discovery mode information, such as scan type, count, and time between scans. | ||
| WDI_TLV_SCAN_DWELL_TIME | Scanning dwell time settings. | ||
| WDI_TLV_P2P_DISCOVERY _CHANNEL_SETTINGS | X | X | Scan duration and list of channels to scan. When specified, the listen settings override those specified in WDI_TLV_SCAN_DWELL_TIME. If this list is empty, the port must scan on all supported channels and use the listen settings from WDI_TLV_SCAN_DWELL_TIME. |
| WDI_TLV_SSID | X | X | A list of SSIDs that the port should scan for. There can be multiple SSIDs in this list and one of them can be a wildcard. When doing an active scan on a channel, the port must send a probe request for each SSID in the list. If this list is empty, the port must scan for all SSIDs. |
| WDI_TLV_P2P_SERVICE_NAME_HASH | X | X | A list of Service Hash names to be queried. Required if WDI_P2P_SERVICE_DISCOVERY_TYPE_SERVICE_NAME_ONLY or WDI_P2P_SERVICE_DISCOVERY_TYPE_ASP2_SERVICE_NAME_ONLY is specified. |
| WDI_TLV_VENDOR_SPECIFIC_IE | X | One or more IEs that must be included in the probe requests sent by the port. These IEs are not used for passive scan. | |
| WDI_TLV_P2P_SERVICE_INFORMATION_DISCOVERY_ENTRY | X | X | An optional list of Service Information Discovery Entries to be queried. This is required if WDI_P2P_SERVICE_DISCOVERY_TYPE_SERVICE_INFORMATION is specified. The driver is expected to perform a P2P service discovery over probe request/response using the service name hash. For each service entry that contains service information, the driver is expected to perform an ANQP query request/response to query the service information. |
| X | X |
Added in Windows 10, version 1607, WDI version 1.0.21. An optional list of ASP2 Service Information Discovery Entries to be queried. This is required if WDI_P2P_SERVICE_DISCOVERY_TYPE_ASP2_SERVICE_INFORMATION is specified. The driver is expected to perform a P2P service discovery over probe request/response using the service name hash. For each service entry that contains service information, the driver is expected to perform an ANQP query request/response to query the service information. |
|
X |
Added in Windows 10, version 1607, WDI version 1.0.21. Specifies whether the probe request should include the Listen Channel attribute during discovery. |
Task completion indication
NDIS_STATUS_WDI_INDICATION_P2P_DISCOVERY_COMPLETE
Unsolicited indication
NDIS_STATUS_WDI_INDICATION_BSS_ENTRY_LIST
Requirements
Minimum supported client |
Windows 10 |
Minimum supported server |
Windows Server 2016 |
Header |
Dot11wdi.h |