Fungsi DrmAddContentHandlers (drmk.h)

Artikel
08/07/2023

Fungsi ini DrmAddContentHandlers menyediakan sistem dengan daftar fungsi yang menangani konten yang dilindungi.

Sintaks

NTSTATUS DrmAddContentHandlers(
  [in] ULONG ContentId,
  [in] PVOID *paHandlers,
  [in] ULONG NumHandlers
);

Parameter

[in] ContentId

Menentukan ID konten DRM. Parameter ini mengidentifikasi aliran audio KS yang dilindungi.

[in] paHandlers

Penunjuk ke array penunjuk fungsi. Setiap elemen array menunjuk ke handler konten.

[in] NumHandlers

Menentukan jumlah penunjuk fungsi dalam array paHandlers .

Nilai kembali

DrmAddContentHandlers mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, kode kesalahan akan menampilkan kode kesalahan yang sesuai.

Keterangan

Sebelum mengizinkan konten yang dilindungi mengalir melalui jalur data, sistem memverifikasi bahwa jalur data aman. Untuk melakukannya, sistem mengautentikasi setiap modul di jalur data yang dimulai di ujung hulu jalur data dan memindahkan hilir. Saat setiap modul diautentikasi, modul tersebut memberikan informasi sistem tentang modul berikutnya di jalur data sehingga juga dapat diautentikasi. Agar berhasil diautentikasi, file biner modul harus ditandatangani sebagai sesuai dengan DRM.

Jika dua modul yang berdekatan berkomunikasi satu sama lain melalui fungsi IoCallDriver atau antarmuka COM modul hilir, modul upstream memanggil fungsi DrmForwardContentToInterface atau DrmForwardContentToDeviceObject , masing-masing, untuk memberi sistem informasi tentang modul hilir. Namun, jika kedua modul menggunakan jenis antarmuka lain untuk berkomunikasi, modul hulu memanggil fungsi sebagai gantinya DrmAddContentHandlers .

Array paHandlers berisi penunjuk fungsi ke titik masuk dalam modul hilir. DrmAddContentHandlers mengautentikasi modul yang mengimplementasikan fungsi-fungsi ini. (Jika titik masuk didistribusikan di antara beberapa modul, fungsi mengautentikasi semua modul ini.) Fungsi yang ditentukan vendor dalam array ini membentuk antarmuka yang dipahami oleh modul yang memanggil fungsi dan modul yang mengimplementasikan fungsi. DrmAddContentHandlers tidak secara langsung memanggil salah satu fungsi ini.

Modul upstream dapat meneruskan ID konten dan hak konten ke modul hilir dengan menggunakan salah satu fungsi dalam array paHandlers untuk tujuan ini. Modul hilir memerlukan ID konten untuk memberi tahu sistem modul apa pun yang dikirimnya ke konten yang dilindungi.

DrmAddContentHandlers melakukan fungsi yang sama dengan PcAddContentHandlers dan IDrmPort2::AddContentHandlers. Untuk informasi selengkapnya, lihat Fungsi dan Antarmuka DRM.