Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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 szNotifyCancelEventNamenumber.
- 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 szNotifyEventNamebuffer.
- pdwNotifyNameEventActualSize
-
[out] Amount of szNotifyEventNamebuffer 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 szNotifyEventNamenamed event.