DdqGetDiagnosticRecordPage 函数 （diagnosticdataquery.h）

提取筛选记录的页面（批处理）。 在内部使用 searchCriteria、pageRecordCount、offset 和 baseRowId DIAGNOSTIC_DATA_SEARCH_CRITERIA输入参数对返回的记录执行筛选。

Syntax

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

参数

hSession

类型： 诊断 数据查询会话的 HANDLE 句柄。

searchCriteria

类型： DIAGNOSTIC_DATA_SEARCH_CRITERIA* 指向包含此作搜索条件的资源的指针。 此资源包含生成者、类别和标记等条件。

offset

类型： UINT32 通过返回从 baseRowId 偏移量开始的 rowId 的记录来筛选结果。

pageRecordCount

类型： UINT32 所需记录页中的记录数

baseRowId

类型： INT64 仅返回 rowId 值小于或等于 baseRowId 的记录来筛选出新记录（如果查询代码希望将结果限制为仅在 DdqGetDiagnosticRecordStats 调用时可用的事件，这很有用。maxRowId 参数可用作 baseRowId。 如果为 baseRowId 传递了 –1，则不会应用筛选。

hRecord

类型： HANDLE* 此输出参数是指向包含匹配记录列表的资源句柄的指针。

返回值

类型： HRESULT 在成功完成时返回S_OK。

要求