IWMDMProgress::Begin method (mswmdm.h)

Artikel
02/29/2024

Metode Mulai menunjukkan bahwa operasi dimulai. Perkiraan durasi operasi disediakan jika memungkinkan.

Sintaks

HRESULT Begin(
  [in] DWORD dwEstimatedTicks
);

Parameter

[in] dwEstimatedTicks

DWORD menentukan perkiraan jumlah kutu yang diperlukan agar operasi selesai.

Nilai kembali

Aplikasi harus mengembalikan salah satu nilai HRESULT berikut.

Menampilkan kode	Deskripsi
S_OK	Operasi harus dilanjutkan.
WMDM_E_USER_CANCELLED	Pengelola Perangkat Media Windows harus membatalkan operasi saat ini tanpa menunggunya selesai. Jika aplikasi menggunakan mode blokir, maka Windows Media Device Manager akan mengembalikan kesalahan ini ke aplikasi.

Keterangan

Operasi ini dipanggil oleh berbagai metode untuk menunjukkan bahwa operasi dimulai. Jumlah kutu yang diteruskan dalam dwEstimatedTicks adalah perkiraan berapa banyak kutu yang diperlukan agar operasi selesai. Selama operasi, metode Kemajuan dipanggil untuk menunjukkan berapa banyak kutu yang telah ditranspitasi. Aplikasi dapat menggunakan perkiraan untuk mengonfigurasi mekanisme tampilan yang menunjukkan kemajuan.

Metode IWMDMProgress3::Begin3 memberikan informasi selengkapnya tentang tindakan apa yang terjadi.

Contoh

Kode C++ berikut adalah implementasi dari metode Mulai .


HRESULT Begin(DWORD  dwEstimatedTicks)
{
    // TODO: Display the message: "IWMDMProgress::Begin called.: "
    // followed by the dwEstimatedTicks value.
    return S_OK;
}