функция обратного вызова PFND3D10DDI_CHECKCOUNTER (d3d10umddi.h)

Статья
08/07/2023

Функция CheckCounter извлекает сведения, описывающие счетчик.

Синтаксис

PFND3D10DDI_CHECKCOUNTER Pfnd3d10ddiCheckcounter;

void Pfnd3d10ddiCheckcounter(
            D3D10DDI_HDEVICE unnamedParam1,
            D3D10DDI_QUERY unnamedParam2,
            D3D10DDI_COUNTER_TYPE *unnamedParam3,
            UINT *unnamedParam4,
            LPSTR unnamedParam5,
  [in, out] UINT *pNameLength,
            LPSTR unnamedParam7,
  [in, out] UINT *pUnitsLength,
            LPSTR unnamedParam9,
  [in, out] UINT *pDescriptionLength
)
{...}

Параметры

unnamedParam1

hDevice [in]

Дескриптор устройства отображения (графический контекст).

unnamedParam2

Запрос [в]

D3D10DDI_QUERY типизированное значение, определяющее идентификатор счетчика, для которого извлекаются сведения.

unnamedParam3

pCounterType [out]

Указатель на переменную, которая получает одно из следующих значений из перечисления D3D10DDI_COUNTER_TYPE, определяющего тип данных, выводимый счетчиком.

Значение	Значение
D3D10DDI_COUNTER_TYPE_FLOAT32	Одноточие с плавающей точкой
D3D10DDI_COUNTER_TYPE_UINT16	16-разрядное значение
D3D10DDI_COUNTER_TYPE_UINT32	32-разрядное значение
D3D10DDI_COUNTER_TYPE_UINT64	64-разрядное значение

unnamedParam4

pDescription [out]

Указатель, в который драйвер возвращает строку, завершающуюся значением NULL, которая содержит описание того, что измеряет идентификатор счетчика.

unnamedParam5

pActiveCounters [out]

Указатель на переменную, которая получает количество одновременно активных счетчиков, выделенных для создания идентификатора счетчика, идентифицируется запросом .

[in, out] pNameLength

Указатель на переменную, которая получает размер строки, завершаемой значением NULL, в байтах, указанной параметром pName .

unnamedParam7

pName [out]

Указатель на то, что драйвер возвращает строку, завершающуюся значением NULL, которая содержит имя идентификатора счетчика.

[in, out] pUnitsLength

Указатель на переменную, которая получает размер строки, завершаемой значением NULL, в байтах, указанной параметром pUnits .

unnamedParam9

pUnits [out]

Указатель, в который драйвер возвращает строку, завершающуюся значением NULL, которая содержит имя единиц измерения идентификатора счетчика.

[in, out] pDescriptionLength

Указатель на переменную, которая получает размер строки, завершаемой значением NULL, в байтах, указанной параметром pDescription .

Возвращаемое значение

None

Remarks

Драйвер может использовать функцию обратного вызова pfnSetErrorCb , чтобы задать код ошибки.

Функция CheckCounter драйвера может вызывать функцию обратного вызова pfnSetErrorCb , чтобы задать код ошибки ERR_UNSUPPORTED, если параметр Queryпараметра CheckCounterуказывает известный счетчик, который устройство не поддерживает.

Драйвер должен проверить идентификатор счетчика, зависящий от устройства, чтобы убедиться, что идентификатор находится в пределах диапазона. Драйвер также должен обеспечить достаточно места для копирования каждой строки счетчика в каждый буфер, предоставляемый средой выполнения Microsoft Direct3D. Драйвер может вызвать функцию обратного вызова pfnSetErrorCb , чтобы задать код ошибки E_INVALIDARG, если для любого из предоставленных буферов недостаточно места.

Функция CheckCounter драйвера не может вызвать функцию обратного вызова pfnSetErrorCb, чтобы задать код ошибки D3DDDIERR_DEVICEREMOVED, так как CheckCounter является функцией проверка возможности. Драйвер должен убедиться, что у него достаточно информации после создания устройства, чтобы ответить на вызов CheckCounter даже при наличии D3DDDIERR_DEVICEREMOVED.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	d3d10umddi.h (включая D3d10umddi.h)

См. также раздел

D3D10DDI_DEVICEFUNCS

D3D10DDI_QUERY

pfnSetErrorCb

Share via