NPA_Unregister_Event_Notification

Deregisters a notification procedure previously registered with NPA_Register_For_Event_Notification.

Thread Context:Blocking
Requirements:Must be called only from a blocking process level.

Syntax

    LONG NPA_Unregister_Event_Notification (
       LONG   npaHandle,
       LONG   eventHandle
       );

Parameters

npaHandle
(IN) The CDM's or HAM's module handle for using the NPA APIs, assigned during NPA_Register_CDM_Module or NPA_Register_HAM_Module, respectively.
eventHandle
(IN) 32-bit value identifying the notification procedure to be deregistered. This value was output by NPA_Register_For_Event_Notification when the notification procedure was registered.

Return Values

The following table lists return values and descriptions.

zero

Deregistering the notification procedure was successful.

-1

eventHandle was an invalid parameter, and/or npaHandle was not entered.

Remarks

NPA_Unregister_Event_Notification removes the notification procedure specified in eventHandle from a list of procedures scheduled to be called by the Media Manager prior to (or following) specific system events.

The notification-procedure identifier, eventHandle, is an output parameter of NPA_Register_For_Event_Notification, which is the function used to register the procedure. If a notification procedure was registered, then it must be deregistered prior to the driver being unloaded.