IOCTL_RIL_NOTIFICATIONS (Windows Embedded CE 6.0)

1/6/2010

This IOCTL is responsible for initializing any data structures and events used to notify the RIL proxy of asynchronous command completion and unsolicited notifications.

Parameters

  • hDevice
    [in] Handle to a RIL stream driver instance returned by CreateFile.
  • szNotifyCancelEventName
    [in] Name of the vent used by the RIL driver to notify the RIL proxy not to wait for future notifications. This event is not currently implemented. The RIL proxy automatically discontinues waiting for notifications when a client calls RIL_Deinitialize.
  • dwNotifyCancelEventNameSize
    [in] Specifies the size, in bytes, of the szNotifyCancelEventName number.
  • szNotifyEventName
    [out] Name of the event used by the RIL driver to notify the RIL proxy that there is a new command result or an unsolicited notification available.
  • dwNotifyNameEventSize
    [in] Specifies the size, in bytes, of the szNotifyEventName buffer.
  • pdwNotifyNameEventActualSize
    [out] Amount of szNotifyEventName buffer space used by the event name.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

This IOCTL is called once each RIL instance during initialization to exchange the name of events to be used for notifications.

When a new asynchronous command result is ready, the RIL driver should trigger the szNotifyEventName named event.

See Also

Reference

RIL IOCTLs
RIL_Deinitialize