Metode IWMDMProgress3::End3 (mswmdm.h)

Artikel
02/29/2024

Metode End3 dipanggil oleh Windows Media Device Manager untuk menunjukkan bahwa operasi telah selesai. Metode ini memperluas IWMDMProgress2::End2 dengan memberikan parameter input tambahan untuk identifikasi (ID) peristiwa dan untuk penunjuk ke konteks perintah.

Sintaks

HRESULT End3(
  [in]      GUID          EventId,
  [in]      HRESULT       hrCompletionCode,
  [in, out] OPAQUECOMMAND *pContext
);

Parameter

[in] EventId

GUID yang menentukan peristiwa yang berakhir. Kemungkinan nilai ditunjukkan dalam tabel berikut.

Kejadian	Deskripsi
SCP_EVENTID_ACQSECURECLOCK	Pengelola Perangkat Media Windows memperoleh jam aman dari server.
SCP_EVENTID_NEEDTOINDIV	Perangkat sedang disortir. Ini saat ini tidak digunakan.
SCP_EVENTID_DRMINFO	ID kejadian ini digunakan untuk memberi tahu aplikasi dengan header DRM versi yang ditemukan dalam konten untuk setiap file. Struktur OPAQUECOMMAND yang dikembalikan memiliki anggota guidCommand yang diatur ke SCP_PARAMID_DRMVERSION. Selain itu, data menentukan salah satu bendera berikut: WMDM_SCP_DRMINFO_NOT_DRMPROTECTED WMDM_SCP_DRMINFO_V1HEADER WMDM_SCP_DRMINFO_V2HEADER
EVENT_WMDM_CONTENT_TRANSFER	Konten sedang ditransfer ke atau dari perangkat.

[in] hrCompletionCode

HRESULT menentukan kode penyelesaian operasi yang sedang berlangsung. Parameter hrCompletionCode adalah kode pengembalian operasi yang berakhir. Parameter ini dapat berupa HRESULT apa pun, termasuk kode kesalahan COM standar, kode kesalahan Win32 yang dikonversi ke HRESULT, atau kode kesalahan Windows Media Device Manager.

[in, out] pContext

Penunjuk ke struktur OPAQUECOMMAND yang berisi perintah yang dikirim langsung ke perangkat tanpa ditangani oleh Windows Media Device Manager. Parameter ini bersifat opsional dan dapat berupa NULL. Struktur konteks adalah cara bagi komponen untuk mengirim data yang relevan dengan peristiwa ke aplikasi. Komponen yang mengirim struktur ini harus menentukan bagaimana aplikasi dapat menginterpretasikan struktur data ini.

Nilai kembali

Pengelola Perangkat Media Windows mengabaikan kode pengembalian apa pun yang dikembalikan oleh metode End3 karena operasi saat ini selesai atau dibatalkan sebelum metode ini dipanggil.

Keterangan

Antarmuka yang memiliki metode yang mengimplementasikan operasi memanggil End3 ketika operasi yang ditentukan oleh metode selesai.

Contoh

Kode C++ berikut menunjukkan contoh implementasi End3.


HRESULT End3(GUID  EventId, HRESULT  hrCompletionCode, OPAQUECOMMAND*  pContext)
{
    // TODO: Display the message "IWMDMProgress3::End3 called."
    return S_OK;
}