Метод ID3DUserDefinedAnnotation::BeginEvent (d3d11_1.h)
Помечает начало раздела кода события.
Синтаксис
INT BeginEvent(
[in] LPCWSTR Name
);
Параметры
[in] Name
Строка ЮНИКОД, завершающаяся null, которая содержит имя события. Имя не относится к операционной системе. Вы можете выбрать понятное имя, если вызывающее приложение выполняется в средстве профилирования Direct3D. Указатель NULL дает неопределенные результаты.
Возвращаемое значение
Возвращает количество предыдущих вызовов BeginEvent , которые еще не были завершены вызовами метода ID3DUserDefinedAnnotation::EndEvent .
Возвращаемое значение равно –1, если вызывающее приложение не выполняется в средстве профилирования Direct3D.
Комментарии
Чтобы отметить конец раздела кода события, вызовите метод EndEvent .
Пользователь может визуализировать событие, когда вызывающее приложение работает с включенным средством профилирования Direct3D, например Microsoft Visual Studio Ultimate 2012.
BeginEvent не действует, если вызывающее приложение не выполняется с включенным средством профилирования Direct3D.
Примеры
В следующем коде показано, как использовать пару вызовов методов BeginEvent и EndEvent . Он также использует тип интеллектуального указателя CComPtr .
CComPtr< ID3D11DeviceContext > pContext;
HRESULT hrCreateDevice = (*pfnD3D11CreateDevice)(
0,
D3D_DRIVER_TYPE_NULL,
0,
0,
NULL,
0,
D3D11_SDK_VERSION,
NULL,
0,
& pContext );
VERIFY_SUCCEEDED(hrCreateDevice);
CComPtr<ID3DUserDefinedAnnotation> pPerf;
HRESULT hr = pContext->QueryInterface( __uuidof(pPerf), reinterpret_cast<void**>(&pPerf) );
if ( FAILED( hr ) )
return;
pPerf->BeginEvent( L”Now entering ocean rendering code” );
MyDrawOceanRoutine( );
pPerf->EndEvent( );
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 и обновление платформы для Windows 7 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | d3d11_1.h |
| Библиотека | D3D11.lib |