GPIO_CLX_ProcessAddDevicePostDeviceCreate function (gpioclx.h)

  • Article

The GPIO_CLX_ProcessAddDevicePostDeviceCreate method passes a framework device object to the GPIO framework extension (GpioClx).

Syntax

NTSTATUS GPIO_CLX_ProcessAddDevicePostDeviceCreate(
  [in] WDFDRIVER Driver,
  [in] WDFDEVICE Device
);

Parameters

[in] Driver

A WDFDRIVER handle to the framework driver object for the GPIO controller driver.

[in] Device

A WDFDEVICE handle to the framework device object that represents the GPIO controller. The caller obtained this handle from the WdfDeviceCreate call that created the device object.

Return value

GPIO_CLX_ProcessAddDevicePostDeviceCreate returns STATUS_SUCCESS if the call is successful. Possible return values include the following error codes.

Return code Description
STATUS_INVALID_PARAMETER
 The caller is not a registered client of GpioClx.
STATUS_UNSUCCESSFUL
 The framework failed to find the device name of the GPIO controller.
STATUS_INSUFFICIENT_RESOURCES
 Out of memory.

Remarks

Your GPIO controller driver must call this method in its EvtDriverDeviceAdd callback function, after the call to the WdfDeviceCreate method that creates the device object (FDO) that represents the GPIO controller. Otherwise, GpioClx cannot handle I/O requests or process interrupts for the new device object.

For a code example that contains a call to GPIO_CLX_ProcessAddDevicePostDeviceCreate, see GPIO_CLX_ProcessAddDevicePreDeviceCreate.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 8.
Target Platform Universal
Header gpioclx.h
Library Msgpioclxstub.lib
IRQL PASSIVE_LEVEL

See also

EvtDriverDeviceAdd

GPIO_CLX_ProcessAddDevicePreDeviceCreate

WdfDeviceCreate