UdecxUsbDeviceInitAllocate function (udecxusbdevice.h)

Article
02/22/2024

Allocates memory for a UDECXUSBDEVICE_INIT structure that is used to initialize a virtual USB device.

Syntax

PUDECXUSBDEVICE_INIT UdecxUsbDeviceInitAllocate(
  [in] WDFDEVICE UdecxWdfDevice
);

Parameters

[in] UdecxWdfDevice

A handle to a framework device object that represents the a USB device. The client driver initialized this object in the previous call to UdecxWdfDeviceAddUsbDeviceEmulation.

Return value

This method returns a pointer to an opaque UDECXUSBDEVICE_INIT that contains the initialization parameters. The structure is allocated by the USB device emulation class extension (UdeCx).

Remarks

The UDE client driver calls this method to allocate parameters for the virtual device that is created by a subsequent call to UdecxUsbDeviceCreate. If the device is not created or the driver is finished using the resources, the driver must free the resources by calling UdecxUsbDeviceInitFree.

Requirements

Requirement	Value
Minimum supported client	Windows 10
Minimum supported server	Windows Server 2016
Target Platform	Windows
Minimum KMDF version	1.15
Header	udecxusbdevice.h (include Udecx.h)
Library	Udecxstub.lib
IRQL	PASSIVE_LEVEL