PFND3D11_1DDI_CREATECRYPTOSESSION fungsi panggilan balik (d3d10umddi.h)

  • Artikel

Membuat sesi kriptografi untuk mengenkripsi konten video yang dikirim ke driver miniport tampilan.

Sintaks

PFND3D11_1DDI_CREATECRYPTOSESSION Pfnd3d111DdiCreatecryptosession;

HRESULT Pfnd3d111DdiCreatecryptosession(
  D3D10DDI_HDEVICE hDevice,
  const D3D11_1DDIARG_CREATECRYPTOSESSION *pCreateData,
  D3D11_1DDI_HCRYPTOSESSION hCryptoSession,
  D3D11_1DDI_HRTCRYPTOSESSION hRTCryptoSession
)
{...}

Parameter

hDevice

Handel ke perangkat tampilan (konteks grafis).

pCreateData

Penunjuk ke struktur D3D11_1DDIARG_CREATECRYPTOSESSION . Struktur ini menentukan atribut sesi kriptografi yang akan dibuat.

hCryptoSession

Handel ke data pribadi driver untuk sesi kriptografi. Untuk informasi lebih lanjut, lihat bagian Keterangan.

hRTCryptoSession

Handel ke sesi kriptografi yang harus digunakan driver saat memanggil kembali ke runtime Direct3D.

Menampilkan nilai

Mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
S_OK Saluran terautentikasi berhasil dibuat.
D3DDDIERR_DEVICEREMOVED Adaptor grafis telah dihapus.
D3DDDIERR_UNSUPPORTEDCRYPTO Jenis kriptografi ditentukan yang tidak didukung oleh profil dekode.
E_OUTOFMEMORY Memori tidak tersedia untuk menyelesaikan operasi.

Keterangan

Runtime Direct3D memanggil CreateCryptoSession untuk membuat sesi kriptografi yang digunakan runtime untuk mengelola kunci sesi dan melakukan operasi kriptografi untuk konten video yang disimpan dalam memori yang dilindungi.

Runtime memanggil CreateCryptoSession setelah memanggil CalcPrivateCryptoSessionSize driver untuk menentukan ukuran dalam byte untuk data privat yang diperlukan driver untuk sesi kriptografi. Runtime mengalokasikan memori untuk data privat ini untuk driver. Driver menggunakan memori ini untuk menyimpan data privat yang terkait dengan sesi kriptografi.

Ketika runtime memanggil CreateCryptoSession, runtime meneruskan handel ke memori data privat dalam parameter hCryptoSession . Handel ini sebenarnya adalah penunjuk ke memori.

Driver harus melacak handel ke perangkat tampilan yang digunakan untuk membuat sesi kriptografi. Driver harus gagal semua panggilan berikutnya yang menggunakan sesi kriptografi yang dibuat ini, seperti NegosiasiCryptoSessionKeyExchange, jika perangkat tampilan yang ditentukan dalam panggilan tersebut berbeda dari perangkat tampilan yang digunakan untuk membuat sesi kriptografi.

Jika anggota DecodeProfile dari struktur D3D11_1DDIARG_CREATECRYPTOSESSION diatur ke NULL_GUID, sesi kriptografi tidak akan digunakan untuk pendekodean DirectX Video Acceleration (DXVA). Jika DecodeProfile tidak diatur ke NULL_GUID, driver harus gagal dalam panggilan dengan D3DDDIERR_UNSUPPORTEDCRYPTO jika anggota CryptoType diatur ke jenis kriptografi yang tidak didukung oleh profil dekode.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8
Server minimum yang didukung Windows Server 2012
Target Platform Desktop
Header d3d10umddi.h (termasuk D3d10umddi.h)

Lihat juga

CalcPrivateCryptoSessionSize

D3D11_1DDIARG_CREATECRYPTOSESSION

NegosiasiCryptoSessionKeyExchange