GPIO_CLX_ProcessAddDevicePostDeviceCreate method

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

Driver [in]

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

Device [in]

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 codeDescription
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

Target platform

Universal

Version

Available starting with Windows 8.

Header

Gpioclx.h

IRQL

PASSIVE_LEVEL

See also

EvtDriverDeviceAdd
GPIO_CLX_ProcessAddDevicePreDeviceCreate
WdfDeviceCreate

 

 

Send comments about this topic to Microsoft

Show: