EVT_WIFI_DEVICE_CREATE_WIFIDIRECTDEVICE callback function (wificx.h)

Article
02/22/2024

WiFiCx client drivers implement EvtWifiDeviceCreateWifiDirectDevice to create a WIFIDIRECTDEVICE object.

Syntax

EVT_WIFI_DEVICE_CREATE_WIFIDIRECTDEVICE EvtWifiDeviceCreateWifidirectdevice;

NTSTATUS EvtWifiDeviceCreateWifidirectdevice(
  WDFDEVICE Device,
  WIFIDIRECT_DEVICE_INIT *WifiDirectDeviceInit
)
{...}

Parameters

Device

[In] A handle to a framework device object that the client driver obtained from a previous call to WdfDeviceCreate.

WifiDirectDeviceInit

[Inout] A pointer to a WIFIDIRECT_DEVICE_INIT object that describes the initialization information for the WIFIDIRECTDEVICE object.

Return value

This callback function returns STATUS_SUCCESS if the operation was successful. Otherwise, it returns an appropriate NTSTATUS error code.

Remarks

A WiFiCx client driver registers the EvtWifiDeviceCreateWifiDirectDevice callback function by calling WiFiDeviceInitialize.

In its EvtWifiDeviceCreateWifiDirectDevice callback, the client driver:

Calls WifiDirectDeviceCreate to create the WIFIDIRECTDEVICE object.
Calls WifiDirectDeviceInitialize to initialize the object.
Calls WifiDirectDeviceGetPortId to determine the port id (which is used in command messages).

For a code example of implementing EvtWifiDeviceCreateWifiDirectDevice, see Wi-Fi Direct (P2P) Support.

Requirements

Requirement	Value
Minimum supported client	Windows 11
Minimum supported server	Windows Server 2022
Header	wificx.h
IRQL	PASSIVE_LEVEL