DdqGetDiagnosticRecordStats function (diagnosticdataquery.h)

Fetches the filtered event transcript Diagnostic Data record stats. The filtering on statistics returned is performed using the input parameter, DIAGNOSTIC_DATA_SEARCH_CRITERIA filter. The record state describes how many records matching the search criteria are available, and returns parameters used for further querying of data. One of the uses of this API is to check if there have been changes since the last time data was queried for. A change in the output parameters indicate a change in state of the event transcript record state.

Syntax

HRESULT DdqGetDiagnosticRecordStats(
  HDIAGNOSTIC_DATA_QUERY_SESSION        hSession,
  DIAGNOSTIC_DATA_SEARCH_CRITERIA const *searchCriteria,
  UINT32                                *recordCount,
  INT64                                 *minRowId,
  INT64                                 *maxRowId
);

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.

recordCount

Type: UINT32* This output parameter is the pointer to the number of records that match on the search criteria.

minRowId

Type: INT64* This output parameter is the pointer to the minimum row id of the record that matches on the search criteria.

maxRowId

Type: INT64* This output parameter is the pointer to the maximum row id of the record that matches on the search criteria.

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