SerCx2InitializeDevice function (sercx.h)
The SerCx2InitializeDevice method finishes initializing the framework device object for the serial controller.
Syntax
NTSTATUS SerCx2InitializeDevice(
[in] WDFDEVICE Device,
[in] PSERCX2_CONFIG Config
);
Parameters
[in] Device
A WDFDEVICE handle to the framework device object that represents the serial controller. For more information, see Remarks.
[in] Config
A pointer to a caller-allocated SERCX2_CONFIG structure that contains pointers to a set of event callback functions that are implemented by the serial controller driver. Version 2 of the serial framework controller (SerCx2) calls these functions to configure the serial controller and to perform basic operations that are independent of the I/O transaction types (PIO, system DMA, or custom) that the driver supports.
Return value
SerCx2InitializeDevice returns STATUS_SUCCESS if the call is successful. Possible error return values include the following status codes.
| Return code | Description |
|---|---|
|
The method was called at the wrong IRQL, or the Device parameter is not a valid WDFDEVICE handle. |
|
The Config->Size value does not equal sizeof(SERCX2_CONFIG). |
|
The RequestAttributes member is not valid, or required callback functions are missing from the list of function pointers. For more information, see Remarks. |
|
Insufficient resources are available to perform the requested operation. |
Remarks
Before calling this method, the serial controller driver must previously have called the SerCx2InitializeDeviceInit method.
The serial controller driver must call this method from its EvtDriverDeviceAdd callback function after it creates a framework device object for the serial controller. The driver typically calls a method such as WdfDeviceCreate to create the framework device object and to obtain a WDFDEVICE handle to this object.
Three of the function pointers in the SERCX2_CONFIG structure are required by SerCx2. The driver must implement the EvtSerCx2PurgeFifos, EvtSerCx2Control, and EvtSerCx2ApplyConfig callback functions. Otherwise, the SerCx2InitializeDevice call fails and returns STATUS_INVALID_PARAMETER.
If the RequestAttributes member of the SERCX2_CONFIG structure is set to a value other than WDF_NO_OBJECT_ATTRIBUTES, the driver must not overwrite the values written to the ParentObject, ExecutionLevel, and SynchronizationScope members of this structure by the WDF_OBJECT_ATTRIBUTES_INIT function. Otherwise, the SerCx2InitializeDevice call fails and returns STATUS_INVALID_PARAMETER.
If the driver calls the WdfDeviceInitSetRequestAttributes method to set the attributes to use for request objects, the request attributes specified in this call must match the request attributes that the driver specifies in the call to SerCx2InitializeDevice. For more information, see SerCx2 Custom-Receive Transactions and SerCx2 Custom-Transmit Transactions.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available starting with Windows 8.1. |
| Target Platform | Universal |
| Header | sercx.h |
| IRQL | PASSIVE_LEVEL |