DXGKCB_READ_DEVICE_SPACE fonction de rappel (dispmprt.h)

Article
02/06/2025

La fonction DxgkCbReadDeviceSpace lit à partir d’un espace de configuration d’appareil ou du ROM d’expansion d’une carte d’affichage.

Syntaxe

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
)
{...}

Paramètres

[in] DeviceHandle

Handle qui représente un adaptateur d’affichage. Le pilote miniport d’affichage a précédemment obtenu ce handle dans le membre DeviceHandle de la structure DXGKRNL_INTERFACE qui a été passée à DxgkDdiStartDevice.

[in] DataType

Type de transaction de lecture à effectuer. Ce paramètre doit être l’une des valeurs suivantes, qui sont définies dans Dispmprt.h.

DXGK_WHICHSPACE_BRIDGE

Lisez l’espace de configuration du port racine PCI Express (PCIe).

DXGK_WHICHSPACE_CONFIG

Lisez l’espace de configuration de l’adaptateur d’affichage.

DXGK_WHICHSPACE_MCH

Lisez l’espace de configuration d’un hub de contrôleur de mémoire qui est un homologue du bus parent de l’adaptateur.

DXGK_WHICHSPACE_ROM

Lisez le ROM d’extension de l’adaptateur d’affichage.

[in] Buffer

Pointeur vers une mémoire tampon allouée par l’appelant qui reçoit les données lues à partir de l’espace de configuration ou du ROM.

[in] Offset

Décalage, dans l’espace de configuration ou le ROM d’extension, auquel commence la transaction de lecture.

[in] Length

Nombre d’octets à lire.

[out] BytesRead

Pointeur vers une variable typée ULONG qui reçoit le nombre d’octets réellement lus.

Valeur de retour

DxgkCbReadDeviceSpace retourne l’une des valeurs suivantes :

Retourner le code	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_INVALID_PARAMETER	Le paramètre DeviceHandle, DataType ou Buffer n’est pas valide.
STATUS_UNSUCCESSFUL	La fonction n’a pas pu lire les données.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
plateforme cible	Bureau
d’en-tête	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL

Voir aussi

DxgkCbWriteDeviceSpace

Partager via