diff -r 89d6a7a84779 -r 25a17d01db0c Symbian3/PDK/Source/GUID-2341CFE1-1CDF-537A-99FB-78C59FFA30CE.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/PDK/Source/GUID-2341CFE1-1CDF-537A-99FB-78C59FFA30CE.dita Fri Jan 22 18:26:19 2010 +0000 @@ -0,0 +1,50 @@ + + + + + +Requesting +Data Notification TutorialExplains how to use the kernel trace tool API to request data notification. +
Purpose

Trace data is written to kernel side chunks. +The kernel trace tool API can request notification that data has been written +and requires further processing.

+
Intended audience

This document is intended for +application developers writing a trace tool using the kernel trace tool component.

+
Required background

The trace filters defined in EUser. +The kernel trace tool component in general.

+
Introduction

Requesting data notification is a +short task which is performed in combination with related tasks as explained +in Kernel Trace Tool +Tutorial.

+
Using Kernel Trace tool to request data notification

The +Following tasks will be covered in this tutorial:

    +
  • Requesting data notification.

  • +
+
Basic procedure

The high level steps to requesting +data notification are shown here:

    +
  1. Request data notification, +specifying the minimum number of bytes to return.

  2. +
+
Using the API

These are the function calls required +to

    +
  1. Call the RequestData() function +of the RBTrace object. This function has two arguments:

      +
    • a TRequestStatus object +which takes the value KErrNone when data becomes available, and

    • +
    • a TInt specifying +the minimum number of bytes to return.

    • +

    The TRequestStatus object is intended for use +in the test statement of a loop in which the function call is embedded.

  2. +
+
+Kernel Trace +Tool Overview +Kernel Trace +Tool Tutorial +
\ No newline at end of file