DmiOriginateEvent(3dmi)

DmiOriginateEvent -- originate an event for filtering and delivery

Synopsis

#include <dmi2ci.h>

DmiErrorStatus_t DMI_API
DmiOriginateEvent (
	    	DmiId_t			compId,
	    	DmiString_t*		language,
	    	DmiTimestamp_t*		timestamp,
	    	DmiMultiRowData_t*	rowData );

Description

This function call originates an event for filtering and delivery. Any necessary indication filtering is performed by this function (or by subsequent processing) before the event is forwarded to the management applications.

Implementation note: a compID value of zero (0) specifies that the event was generated by something that has not been installed as a component, and hence has no component ID.

Parameters

compId: (Input) Component reporting the event
language: (Input) language-code | territory-code | encoding
timestamp: (Input) Event generation time
rowData: (Input) Standard and context-specific indication data

Return values

DMIERR_NO_ERROR
DMIERR_ILLEGAL_HANDLE
DMIERR_OUT_OF_MEMORY
DMIERR_INSUFFICIENT_PRIVILEGES
DMIERR_SP_INACTIVE

For a description of return values, see ``DMI error codes'' in Desktop Management Interface programming.

Notices

Portions of this page are derived from material for which the copyright owner is the Desktop Management Task Force. The material is reprinted with permission. See copyright page for a full statement of rights and permissions.