DXGKCB_READ_DEVICE_SPACE fungsi panggilan balik (dispmprt.h)

  • Artikel

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 peer 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.

Nilai kembali

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 Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Desktop
Header dispmprt.h (termasuk Dispmprt.h)
IRQL PASSIVE_LEVEL

Lihat juga

DxgkCbWriteDeviceSpace