DdqGetDiagnosticRecordPage function (diagnosticdataquery.h)

Fetches a page (batch) of filtered records. The filtering on records returned is performed internally using the input parameters DIAGNOSTIC_DATA_SEARCH_CRITERIA searchCriteria, pageRecordCount, offset and baseRowId.

Syntax

HRESULT DdqGetDiagnosticRecordPage(
  HDIAGNOSTIC_DATA_QUERY_SESSION          hSession,
  DIAGNOSTIC_DATA_SEARCH_CRITERIA * const searchCriteria,
  UINT32                                  offset,
  UINT32                                  pageRecordCount,
  INT64                                   baseRowId,
  HDIAGNOSTIC_RECORD                      *hRecord
);

Parameters

hSession

Type: HANDLE Handle to the Diagnostic Data Query session.

searchCriteria

Type: DIAGNOSTIC_DATA_SEARCH_CRITERIA* Pointer to the resource that contains the search criteria for this operation. This resource contains criteria such as producers, categories, and tags.

offset

Type: UINT32 Filters results by returning records with rowId that start at the offset from the baseRowId.

pageRecordCount

Type: UINT32 The number of records in a desired record page

baseRowId

Type: INT64 Filters out new records by returning only records with rowId value less than or equal to baseRowId (this is useful if querying code wants to limit results to only events that were available at the time of DdqGetDiagnosticRecordStats call. The maxRowId parameter can be used as baseRowId). No filtering is applied if –1 is passed for baseRowId.

hRecord

Type: HANDLE* This output parameter is a pointer to the handle for the resource that contains the list of matching records.

Return value

Type: HRESULT Returns S_OK on successful completion.

Requirements

Requirement Value
Minimum supported client Windows 10, version 2004 (10.0; Build 19041)
Minimum supported server Windows Server, version 2004 (10.0; Build 19041)
Header diagnosticdataquery.h