DXGKDDI_OPM_GET_RANDOM_NUMBER fungsi panggilan balik (dispmprt.h)
Fungsi DxgkDdiOPMGetRandomNumber mengambil angka acak 128-bit objek output yang dilindungi yang diberikan secara kriptografis aman.
Sintaks
DXGKDDI_OPM_GET_RANDOM_NUMBER DxgkddiOpmGetRandomNumber;
NTSTATUS DxgkddiOpmGetRandomNumber(
[in] PVOID MiniportDeviceContext,
[in] HANDLE ProtectedOutputHandle,
[out] PDXGKMDT_OPM_RANDOM_NUMBER RandomNumber
)
{...}
Parameter
[in] MiniportDeviceContext
Handel ke blok konteks yang terkait dengan adaptor tampilan. Sebelumnya, fungsi DxgkDdiAddDevice driver miniport tampilan memberikan handel ini ke subsistem kernel grafis DirectX.
[in] ProtectedOutputHandle
Handel ke objek output yang dilindungi. Fungsi DxgkDdiOPMCreateProtectedOutput membuat objek output yang dilindungi dan mengembalikan handel ke objek .
[out] RandomNumber
Pointer ke struktur DXGKMDT_OPM_RANDOM_NUMBER yang menerima angka acak 128-bit yang aman secara kriptografis objek output yang dilindungi jika DxgkDdiOPMGetRandomNumber berhasil dikembalikan.
Jika DxgkDdiOPMGetRandomNumber gagal, nilai yang diacu randomNumber tidak berubah.
Setiap objek output yang dilindungi harus memiliki angka acak 128-bit yang aman secara kriptografis yang berbeda yang terkait dengannya.
Nilai kembali
DxgkDdiOPMGetRandomNumber mengembalikan STATUS_SUCCESS jika berhasil. Jika tidak, ia mengembalikan salah satu kode kesalahan yang didefinisikan dalam Ntstatus.h.
Keterangan
DxgkDdiOPMGetRandomNumber hanya dipanggil sekali untuk setiap output yang dilindungi dan tidak pernah dipanggil setelah panggilan ke fungsi DxgkDdiOPMSetSigningKeyAndSequenceNumbers terjadi.
Untuk informasi selengkapnya tentang angka acak yang aman secara kriptografi, lihat bagian 2.8 di Kriptografi Terapan, Edisi Kedua.
DxgkDdiOPMGetRandomNumber harus dibuat dapat dipaginasi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Desktop |
| Header | dispmprt.h (termasuk Dispmprt.h) |
| IRQL | PASSIVE_LEVEL (lihat bagian Keterangan) |