DXGKCB_READ_DEVICE_SPACE fonction de rappel (dispmprt.h)

  • Article

La fonction DxgkCbReadDeviceSpace lit à partir d’un espace de configuration d’appareil ou de la ROM d’extension 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 une carte d’affichage. Le pilote miniport d’affichage a précédemment obtenu cette poignée dans le membre DeviceHandle de la structure DXGKRNL_INTERFACE qui a été passé à 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

Lit à partir de l’espace de configuration du port racine PCI Express (PCIe).

DXGK_WHICHSPACE_CONFIG

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

DXGK_WHICHSPACE_MCH

Lisez à partir de 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 à partir de la 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 de la ROM.

[in] Offset

Décalage, dans l’espace de configuration ou la ROM d’expansion, à partir duquel la transaction de lecture commence.

[in] Length

Nombre d'octets à lire.

[out] BytesRead

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

Valeur retournée

DxgkCbReadDeviceSpace retourne l’une des valeurs suivantes :

Code de retour 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête dispmprt.h (inclure Dispmprt.h)
IRQL PASSIVE_LEVEL

Voir aussi

DxgkCbWriteDeviceSpace