Home / Autodocs / dos.library
NAME
- EndNotify
-
Ends a notification request (V36)
SYNOPSIS
EndNotify(notifystructure)
VOID EndNotify(struct NotifyRequest *)
D1
FUNCTION
Removes a notification request. Safe to call even if StartNotify() failed. For NRF_SEND_MESSAGE, it searches your port for any messages about the object in question and removes and replies them before returning.
INPUTS
- notifystructure
-
a structure passed to StartNotify()
NOTES
From V47 on, passing in NULL is a no-op.
It is not safe to pass the same notification request to EndNotify() multiple times in a row. Each call to StartNotify() must be followed by exactly one call to EndNotify().
It is not safe to pass the same notification request to EndNotify() multiple times in a row. Each call to StartNotify() must be followed by exactly one call to EndNotify().
BUGS
When EndNotify() returns, the NotifyRequest cannot be safely reused with StartNotify() unless you set its contents to 0, such as by calling memset(request, 0, sizeof(struct NotifyRequest)) and then reinitializing it. Some file systems, such as the floppy/hard disk file system, will show undefined behaviour unless you "clean up" and reinitialize the NotifyRequest first.