RIL_GetSerialPortHandleFromContextID (Compact 2013)
3/26/2014
This function retrieves a serial port handle from the PDP context to be used for data communications.
Syntax
HRESULT RIL_GetSerialPortHandleFromContextID(
HRIL hRil,
DWORD dwContextID,
HANDLE *lphSerial
);
Parameters
- hRil
Handle to the RIL instance returned by RIL_Initialize.
- dwContextID
The PDP context identifier.
- lphSerial
Pointer to the serial port handle.
Return Value
An HRESULT value of S_OK indicates success. HRESULT values of E_XXX indicate an error. Errors are defined in the winerror.h file.
Remarks
This function is synchronous. An asynchronous result callback is not returned.
The parameter dwContextID is input and lphSerial points to the final result. The client is responsible for closing the serial port returned using lphSerial.
The RIL proxy translates the RIL_GetSerialPortHandleFromContextID into IOCTL_RIL_GETSERIALPORTHANDLEFROMCONTEXTID when the RIL proxy calls RIL_IOCONTROL.
Requirements
Header |
ril.h |
Library |
Ril.lib |