DXGKCB_WRITE_DEVICE_SPACE fonction de rappel (dispmprt.h)

  • Article

La fonction DxgkCbWriteDeviceSpace écrit dans un espace de configuration d’appareil ou dans la ROM d’extension d’une carte graphique.

Syntaxe

DXGKCB_WRITE_DEVICE_SPACE DxgkcbWriteDeviceSpace;

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

Paramètres

[in] DeviceHandle

Handle qui représente un adaptateur d’affichage. Le pilote de 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 d’écriture à effectuer. Ce paramètre doit être l’une des valeurs suivantes, qui sont définies dans Dispmprt.h :

DXGK_WHICHSPACE_BRIDGE

Écrivez dans l’espace de configuration de l’appareil de bus parent.

DXGK_WHICHSPACE_CONFIG

Écrivez dans l’espace de configuration de la carte graphique.

DXGK_WHICHSPACE_MCH

Écrivez dans 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

Écrivez dans la ROM d’extension de la carte graphique.

[in] Buffer

Pointeur vers une mémoire tampon qui fournit les données à écrire dans l’espace de configuration.

[in] Offset

Décalage, en octets, dans l’espace de configuration, au niveau duquel la transaction d’écriture commence.

[in] Length

Nombre d'octets à écrire.

[out] BytesWritten

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

Valeur retournée

DxgkCbWriteDeviceSpace 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 écrire les données.

Configuration requise

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

Voir aussi

DxgkCbReadDeviceSpace