DXGKCB_WRITE_DEVICE_SPACE fonction de rappel (dispmprt.h)

Article
05/23/2024

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

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 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 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 l’adaptateur d’affichage.

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 l’adaptateur d’affichage.

[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, à laquelle 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	Windows Vista
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dispmprt.h (inclure Dispmprt.h)
IRQL	PASSIVE_LEVEL

Voir aussi

DxgkCbReadDeviceSpace

Partager via