DXGKCB_READ_DEVICE_SPACE fonction de rappel (dispmprt.h)
La fonction DxgkCbReadDeviceSpace lit à partir d’un espace de configuration d’appareil ou de la ROM d’extension d’une carte graphique.
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 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 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
Lire à partir de l’espace de configuration de l’adaptateur d’affichage.
DXGK_WHICHSPACE_MCH
Lit à 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
Lire à partir de la ROM d’extension de la carte graphique.
[in] Buffer
Pointeur vers une mémoire tampon allouée à 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 la ROM d’extension, à laquelle 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 | Windows Vista |
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | dispmprt.h (include Dispmprt.h) |
IRQL | PASSIVE_LEVEL |