Partager via


Fonction D3DKMTReserveGpuVirtualAddress (d3dkmthk.h)

D3DKMTReserveGpuVirtualAddress réserve une plage d’adresses dans l’espace d’adressage virtuel du processus actuel. La plage d’adresses est uniquement réservée, il n’y a pas de mémoire réelle derrière elle.

Le pilote peut choisir l’adresse virtuelle GPU de base à utiliser pour la réservation en spécifiant une valeur non NULL pour BaseAddress. Le gestionnaire de mémoire vidéo utilise la plage spécifiée si elle est disponible. Si la plage croise une plage existante, l’opération échoue. Le pilote peut passer une valeur NULL dans le membre BaseAddress pour permettre au gestionnaire de mémoire vidéo de choisir une adresse de base.

Lorsque le pilote choisit de laisser le gestionnaire de mémoire vidéo choisir une adresse de base pour la plage d’adresses virtuelles GPU, il peut choisir de limiter la plage que le gestionnaire de mémoire vidéo prendra en compte en spécifiant des valeurs non NULL pour MinimumAddress et MaximumAddress. Le gestionnaire de mémoire vidéo garantit que la plage d’adresses virtuelles GPU allouée est entièrement contenue dans la plage. Le pilote peut spécifier uniquement une Adresse Minimale et le pilote déduit que l’adresse MaximaleAddress est la fin de l’espace d’adressage. Si seule une adresse MaximaleAddress est spécifiée, la valeur MinimumAddress est déduite comme étant 0.

Syntaxe

NTSTATUS D3DKMTReserveGpuVirtualAddress(
  D3DDDI_RESERVEGPUVIRTUALADDRESS *unnamedParam1
);

Paramètres

unnamedParam1

pData [in, out]

Pointeur vers une structure D3DDDI_RESERVEGPUVIRTUALADDRESS qui décrit l’opération.

Valeur retournée

Code de retour Description
STATUS_SUCCESS Le contexte de l’appareil a été créé avec succès.
STATUS_INVALID_PARAMETER Les paramètres ont été validés et déterminés comme incorrects.

Cette fonction peut également retourner d’autres valeurs NTSTATUS .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Universal
En-tête d3dkmthk.h (inclure D3dkmthk.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll