DXGKCB_READ_DEVICE_SPACE fungsi panggilan balik (dispmprt.h)

Artikel
05/23/2024

Fungsi DxgkCbReadDeviceSpace membaca dari ruang konfigurasi perangkat atau ROM ekspansi adaptor tampilan.

Sintaks

DXGKCB_READ_DEVICE_SPACE DxgkcbReadDeviceSpace;

NTSTATUS DxgkcbReadDeviceSpace(
  [in]  HANDLE DeviceHandle,
  [in]  ULONG DataType,
  [in]  PVOID Buffer,
  [in]  ULONG Offset,
  [in]  ULONG Length,
  [out] PULONG BytesRead
)
{...}

Parameter

[in] DeviceHandle

Handel yang mewakili adaptor tampilan. Driver miniport tampilan sebelumnya memperoleh handel ini di anggota DeviceHandle dari struktur DXGKRNL_INTERFACE yang diteruskan ke DxgkDdiStartDevice.

[in] DataType

Jenis transaksi baca yang akan dilakukan. Parameter ini harus merupakan salah satu nilai berikut, yang didefinisikan dalam Dispmprt.h.

DXGK_WHICHSPACE_BRIDGE

Baca dari ruang konfigurasi port akar PCI Express (PCIe).

DXGK_WHICHSPACE_CONFIG

Baca dari ruang konfigurasi adaptor tampilan.

DXGK_WHICHSPACE_MCH

Baca dari ruang konfigurasi hub pengontrol memori yang merupakan serekan ke bus induk adaptor.

DXGK_WHICHSPACE_ROM

Baca dari ROM ekspansi adaptor tampilan.

[in] Buffer

Penunjuk ke buffer yang dialokasikan penelepon yang menerima data yang dibaca dari ruang konfigurasi atau ROM.

[in] Offset

Offset, ke dalam ruang konfigurasi atau ROM ekspansi, di mana transaksi baca dimulai.

[in] Length

Jumlah byte yang akan dibaca.

[out] BytesRead

Penunjuk ke variabel berjenis ULONG yang menerima jumlah byte yang benar-benar dibaca.

Menampilkan nilai

DxgkCbReadDeviceSpace mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil.
STATUS_INVALID_PARAMETER	Parameter DeviceHandle, DataType, atau Buffer tidak valid.
STATUS_UNSUCCESSFUL	Fungsi tidak dapat membaca data.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Target Platform	Desktop
Header	dispmprt.h (termasuk Dispmprt.h)
IRQL	PASSIVE_LEVEL

Lihat juga

DxgkCbWriteDeviceSpace

Bagikan melalui