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 |