EVT_WIFI_DEVICE_CREATE_ADAPTER callback function (wificx.h)

WiFiCx client drivers implement EvtWifiDeviceCreateAdapter to create a NETADAPTER object.

Syntax

EVT_WIFI_DEVICE_CREATE_ADAPTER EvtWifiDeviceCreateAdapter;

NTSTATUS EvtWifiDeviceCreateAdapter(
  WDFDEVICE Device,
  NETADAPTER_INIT *AdapterInit
)
{...}

Parameters

Device

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

AdapterInit

[Inout] A pointer to a NETADAPTER_INIT object that describes the initialization information for the NETADAPTER.

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 must register an EvtWifiDeviceCreateAdapter callback function by calling WiFiDeviceInitialize.

In its EvtWifiDeviceCreateAdapter callback, the client driver must:

  1. Call NetAdapterCreate to create the new NetAdapter object.

  2. Call WifiAdapterInitialize to initialize the WiFiCx context and associate it with this NetAdapter object.

  3. Call NetAdapterStart to start the adapter.

For more information, see Writing a WiFiCx client driver.

Requirements

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

See also

WdfDeviceCreate

WiFiDeviceInitialize

NetAdapterCreate

WifiAdapterInitialize

NetAdapterStart

Writing a WiFiCx client driver