Metode ID3DUserDefinedAnnotation::BeginEvent (d3d11_1.h)

Menandai awal bagian kode peristiwa.

Sintaks

INT BeginEvent(
  [in] LPCWSTR Name
);

Parameter

[in] Name

String UNICODE yang dihentikan NULL yang berisi nama peristiwa. Nama ini tidak relevan dengan sistem operasi. Anda dapat memilih nama yang bermakna saat aplikasi panggilan berjalan di bawah alat pembuatan profil Direct3D. Penunjuk NULL menghasilkan hasil yang tidak terdefinisi.

Nilai kembali

Mengembalikan jumlah panggilan sebelumnya ke BeginEvent yang belum diselesaikan dengan panggilan ke metode ID3DUserDefinedAnnotation::EndEvent .

Nilai yang dikembalikan adalah –1 jika aplikasi panggilan tidak berjalan di bawah alat pembuatan profil Direct3D.

Keterangan

Anda memanggil metode EndEvent untuk menandai akhir bagian kode peristiwa.

Pengguna dapat memvisualisasikan peristiwa saat aplikasi panggilan berjalan di bawah alat pembuatan profil Direct3D yang diaktifkan seperti Microsoft Visual Studio Ultimate 2012.

BeginEvent tidak berpengaruh jika aplikasi panggilan tidak berjalan di bawah alat pembuatan profil Direct3D yang diaktifkan.

Contoh

Kode berikut menunjukkan cara menggunakan sepasang panggilan ke metode BeginEvent dan EndEvent . Ini juga menggunakan jenis penunjuk cerdas 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( );
          

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 dan Pembaruan Platform untuk Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 dan Pembaruan Platform untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	d3d11_1.h
Pustaka	D3D11.lib

Lihat juga

ID3DUserDefinedAnnotation