DiMgslGetTraceEvent

Prototype
`NTSTATUS DiMgslGetTraceEvent( void *Handle, PMGSL_TRACE_EVENT TraceEvent);`
Parameters
`Handle`	handle to open port
`TraceEvent`	pointer to buffer to hold returned trace event
Return Value
`STATUS_SUCCESS`	trace event returned
`STATUS_INVALID_HANDLE`	Handle is invalid
`STATUS_INVALID_PARAMETER`	TraceEvent is invalid.
`STATUS_RETRY`	No trace event is available

Return a trace event in the MGSL_TRACE_EVENT structure specified by TraceEvent.

STATUS_SUCCESS is returned when an event is available and has been copied to the TraceEvent buffer.

STATUS_RETRY is returned if no trace events are available.

When a trace event becomes available, the API calls the TraceReady callback function if defined.