Share via


Concurrency::direct3d, fonctions de l’espace de noms (AMP)

Spécifications

En-tête : espace de noms amp.h : accès concurrentiel

abs

Retourne la valeur absolue de l’argument

inline int abs(int _X) restrict(amp);

Paramètres

_X
Valeur entière

Valeur de retour

Retourne la valeur absolue de l’argument.

Pince

Calcule la valeur du premier argument spécifié limité à une plage définie par les deuxième et troisième arguments spécifiés.

inline float clamp(
    float _X,
    float _Min,
    float _Max) restrict(amp);

inline int clamp(
    int _X,
    int _Min,
    int _Max) restrict(amp);

Paramètres

_X
Valeur à limiter

_Min
Limite inférieure de la plage de pincement.

_Max
Limite supérieure de la plage de pincement.

Valeur de retour

Valeur limitée de _X.

countbits

Compte le nombre de bits définis dans _X

inline unsigned int countbits(unsigned int _X) restrict(amp);

Paramètres

_X
Valeur entière non signée

Valeur de retour

Retourne le nombre de bits définis dans _X

create_accelerator_view

Crée un objet accelerator_view à partir d’un pointeur vers une interface d’appareil Direct3D.

Syntaxe

accelerator_view create_accelerator_view(
    IUnknown * _D3D_device
    queuing_mode _Qmode = queuing_mode_automatic);

accelerator_view create_accelerator_view(
    accelerator& _Accelerator,
    bool _Disable_timeout
    queuing_mode _Qmode = queuing_mode_automatic);

Paramètres

_Accélérateur
Accélérateur sur lequel la nouvelle accelerator_view doit être créée.

_D3D_device
Pointeur vers l’interface de l’appareil Direct3D.

_Disable_timeout
Paramètre booléen qui spécifie si le délai d’attente doit être désactivé pour le accelerator_view nouvellement créé. Cela correspond à l’indicateur de D3D11_CREATE_DEVICE_DISABLE_GPU_TIMEOUT pour la création d’appareils Direct3D et est utilisé pour indiquer si le système d’exploitation doit autoriser l’exécution de charges de travail qui prennent plus de 2 secondes sans réinitialiser l’appareil par le mécanisme de détection et de récupération du délai d’attente Windows. L’utilisation de cet indicateur est recommandée si vous devez effectuer des tâches fastidieuses sur le accelerator_view.

_Qmode
Queuing_mode à utiliser pour le accelerator_view nouvellement créé. Ce paramètre a la valeur queuing_mode_automaticpar défaut .

Valeur de retour

Objet accelerator_view créé à partir de l’interface d’appareil Direct3D passée.

Notes

Cette fonction crée un accelerator_view objet à partir d’un pointeur existant vers une interface d’appareil Direct3D. Si l’appel de fonction réussit, le nombre de références du paramètre est incrémenté au moyen d’un AddRef appel à l’interface. Vous pouvez libérer en toute sécurité l’objet lorsqu’il n’est plus nécessaire dans votre code DirectX. Si l’appel de méthode échoue, une runtime_exception est levée.

L’objet accelerator_view que vous créez à l’aide de cette fonction est thread safe. Vous devez synchroniser l’utilisation simultanée de l’objet accelerator_view . L’utilisation simultanée non synchronisée de l’objet accelerator_view et de l’interface ID3D11Device brute entraîne un comportement non défini.

Le runtime AMP C++ fournit des informations d’erreur détaillées en mode débogage à l’aide de la couche Debug D3D si vous utilisez l’indicateur D3D11_CREATE_DEVICE_DEBUG .

d3d_access_lock

Acquérir un verrou sur un accelerator_view pour effectuer en toute sécurité des opérations D3D sur les ressources partagées avec le accelerator_view. Les accelerator_view et toutes les ressources AMP C++ associées à cette accelerator_view prennent ce verrou en interne lors de l’exécution d’opérations et bloquent alors qu’un autre thread contient le verrou d’accès D3D. Ce verrou n’est pas récursif : il n’est pas défini de comportement pour appeler cette fonction à partir d’un thread qui contient déjà le verrou. Il n’est pas défini de comportement pour effectuer des opérations sur le accelerator_view ou tout conteneur de données associé au accelerator_view à partir du thread qui contient le verrou d’accès D3D. Consultez également scoped_d3d_access_lock, une classe de style RAII pour un verrou d’accès D3D basé sur l’étendue.

void __cdecl d3d_access_lock(accelerator_view& _Av);

Paramètres

_Av
Accelerator_view à verrouiller.

d3d_access_try_lock

Essayez d’acquérir le verrou d’accès D3D sur un accelerator_view sans bloquer.

bool __cdecl d3d_access_try_lock(accelerator_view& _Av);

Paramètres

_Av
Accelerator_view à verrouiller.

Valeur de retour

true si le verrou a été acquis ou false s’il est actuellement détenu par un autre thread.

d3d_access_unlock

Relâchez le verrou d’accès D3D sur la accelerator_view donnée. Si le thread appelant ne tient pas le verrou sur le accelerator_view les résultats ne sont pas définis.

void __cdecl d3d_access_unlock(accelerator_view& _Av);

Paramètres

_Av
Accelerator_view pour laquelle le verrou doit être libéré.

firstbithigh

Obtient l’emplacement du premier bit défini dans _X, en commençant par le bit de l’ordre le plus élevé et en se déplaçant vers le bit de l’ordre le plus bas.

inline int firstbithigh(int _X) restrict(amp);

Paramètres

_X
Valeur entière

Valeur de retour

Emplacement du premier bit défini

firstbitlow

Obtient l’emplacement du premier bit défini dans _X, en commençant par le bit de l’ordre le plus bas et en travaillant vers le bit de l’ordre le plus élevé.

inline int firstbitlow(int _X) restrict(amp);

Paramètres

_X
Valeur entière

Valeur de retour

Retourne l’emplacement du premier bit défini

get_buffer

Obtenez l’interface de mémoire tampon Direct3D sous-jacente au tableau spécifié.

template<
    typename value_type,
    int _Rank
>
IUnknown *get_buffer(
    const array<value_type, _Rank>& _Array)  ;

Paramètres

value_type
Type des éléments dans le tableau.

_Rang
Rang du tableau.

_Array
Tableau sur un accelerator_view Direct3D pour lequel l’interface de mémoire tampon Direct3D sous-jacente est retournée.

Valeur de retour

Pointeur d’interface IUnknown correspondant à la mémoire tampon Direct3D sous-jacente au tableau.

get_device

Obtenez l’interface d’appareil D3D sous-jacente à un accelerator_view.

IUnknown* get_device(const accelerator_view Av);

Paramètres

Av
L’accelerator_view D3D pour laquelle l’interface d’appareil D3D sous-jacente est retournée.

Valeur retournée

Pointeur IUnknown d’interface de l’appareil D3D sous-jacent au accelerator_view.

Imax

Déterminer la valeur numérique maximale des arguments

inline int imax(
    int _X,
    int _Y) restrict(amp);

Paramètres

_X
Valeur entière

_Y
Valeur entière

Valeur de retour

Retourne la valeur numérique maximale des arguments

Administrateur

Déterminer la valeur numérique minimale des arguments

inline int imin(
    int _X,
    int _Y) restrict(amp);

Paramètres

_X
Valeur entière

_Y
Valeur entière

Valeur de retour

Retourner la valeur numérique minimale des arguments

is_timeout_disabled

Retourne un indicateur booléen indiquant si le délai d’attente est désactivé pour la accelerator_view spécifiée. Cela correspond à l’indicateur de D3D11_CREATE_DEVICE_DISABLE_GPU_TIMEOUT pour la création d’appareils Direct3D.

bool __cdecl is_timeout_disabled(const accelerator_view& _Accelerator_view);

Paramètres

_Accelerator_view
La accelerator_view pour laquelle le paramètre de délai d’expiration désactivé doit être interrogé.

Valeur de retour

Indicateur booléen indiquant si le délai d’attente est désactivé pour la accelerator_view spécifiée.

mad

Calcule le produit du premier et du deuxième argument spécifié, puis ajoute le troisième argument spécifié.

inline float mad(
    float _X,
    float _Y,
    float _Z) restrict(amp);

inline double mad(
    double _X,
    double _Y,
    double _Z) restrict(amp);

inline int mad(
    int _X,
    int _Y,
    int _Z) restrict(amp);

inline unsigned int mad(
    unsigned int _X,
    unsigned int _Y,
    unsigned int _Z) restrict(amp);

Paramètres

_X
Premier argument spécifié.

_Y
Deuxième argument spécifié.

_Z
Troisième argument spécifié.

Valeur de retour

Résultat de _X * _Y + _Z.

make_array

Créez un tableau à partir d’un pointeur d’interface de mémoire tampon Direct3D.

template<
    typename value_type,
    int _Rank
>
array<value_type, _Rank> make_array(
    const extent<_Rank>& _Extent,
    const Concurrency::accelerator_view& _Rv,
    IUnknown* _D3D_buffer)  ;

Paramètres

value_type
Type d’élément du tableau à créer.

_Rang
Rang du tableau à créer.

_Mesure
Étendue qui décrit la forme de l’agrégat de tableau.

_Rv
Vue accélérateur D3D sur laquelle le tableau doit être créé.

_D3D_buffer
Pointeur d’interface IUnknown de la mémoire tampon D3D à partir duquel créer le tableau.

Valeur de retour

Tableau créé à l’aide de la mémoire tampon Direct3D fournie.

bruit

Génère une valeur aléatoire à l’aide de l’algorithme de bruit Perlin

inline float noise(float _X) restrict(amp);

Paramètres

_X
Valeur à virgule flottante à partir de laquelle générer le bruit Perlin

Valeur de retour

Retourne la valeur du bruit Perlin dans une plage comprise entre -1 et 1

radians

Convertit _X de degrés en radians

inline float radians(float _X) restrict(amp);

Paramètres

_X
Valeur à virgule flottante

Valeur de retour

Retourne _X convertie de degrés en radians

rcp

Calcule la réciproque de l’argument spécifié à l’aide d’une approximation rapide.

inline float rcp(float _X) restrict(amp);

inline double rcp(double _X) restrict(amp);

Paramètres

_X
Valeur pour laquelle calculer la réciproque.

Valeur de retour

Réciproque de l’argument spécifié.

reversebits

Inverse l’ordre des bits dans _X

inline unsigned int reversebits(unsigned int _X) restrict(amp);

Paramètres

_X
Valeur entière non signée

Valeur de retour

Retourne la valeur avec l’ordre de bits inversé dans _X

Saturer

Pinces _X dans la plage de 0 à 1

inline float saturate(float _X) restrict(amp);

Paramètres

_X
Valeur à virgule flottante

Valeur de retour

Retourne _X limitées dans la plage de 0 à 1

sign

Détermine le signe de l’argument spécifié.

inline int sign(int _X) restrict(amp);

Paramètres

_X
Valeur entière

Valeur de retour

Signe de l’argument.

smoothstep

Retourne une interpolation hermite lisse comprise entre 0 et 1, si _X se trouve dans la plage [_Min, _Max].

inline float smoothstep(
    float _Min,
    float _Max,
    float _X) restrict(amp);

Paramètres

_Min
Valeur à virgule flottante

_Max
Valeur à virgule flottante

_X
Valeur à virgule flottante

Valeur de retour

Retourne 0 si _X est inférieur à _Min ; 1 si _X est supérieur à _Max ; sinon, une valeur comprise entre 0 et 1 si _X se trouve dans la plage [_Min, _Max]

step

Compare deux valeurs, en retournant 0 ou 1 en fonction de la valeur supérieure

inline float step(
    float _Y,
    float _X) restrict(amp);

Paramètres

_Y
Valeur à virgule flottante

_X
Valeur à virgule flottante

Valeur de retour

Retourne 1 si la _X est supérieure ou égale à _Y ; sinon, 0

Umax

Déterminer la valeur numérique maximale des arguments

inline unsigned int umax(
    unsigned int _X,
    unsigned int _Y) restrict(amp);

Paramètres

_X
Valeur entière

_Y
Valeur entière

Valeur de retour

Retourne la valeur numérique maximale des arguments

umin

Déterminer la valeur numérique minimale des arguments

inline unsigned int umin(
    unsigned int _X,
    unsigned int _Y) restrict(amp);

Paramètres

_X
Valeur entière

_Y
Valeur entière

Valeur de retour

Retourner la valeur numérique minimale des arguments

Voir aussi

Concurrency::direct3d, espace de noms