IDXCoreAdapter::SetState, méthode

Article
08/18/2023

Définit l’état de l’élément spécifié sur l’adaptateur. Avant d’appeler SetState pour un type de propriété, appelez IsSetStateSupported pour confirmer que la définition du type d’état est disponible pour cet adaptateur et ce système d’exploitation.

Syntaxe

virtual HRESULT STDMETHODCALLTYPE SetState( 
  DXCoreAdapterState state,
  size_t inputStateDetailsSize,
  _In_reads_bytes_opt_(inputStateDetailsSize) const void *inputStateDetails,
  size_t inputDataSize,
  _In_reads_bytes_(inputDataSize) const void *inputData) = 0;

template <class T1, class T2>
HRESULT SetState( 
  DXCoreAdapterState state,
  const T1 *inputStateDetails,
  const T2 *inputData);

Paramètres

state

Type : DXCoreAdapterState

Type d’élément d’état sur l’adaptateur dont vous souhaitez définir l’état. Pour plus d’informations sur chaque type d’état de carte, consultez le tableau dans DXCoreAdapterState .

inputStateDetailsSize

Type : size_t

Taille, en octets, de la mémoire tampon des détails de l’état d’entrée que vous allouez (éventuellement) et fournissez dans inputStateDetails.

inputStateDetails [in]

Type : void const*

Pointeur facultatif vers une mémoire tampon de détails d’état d’entrée constante que vous allouez dans votre application, contenant toutes les informations sur votre demande requises pour le type d’état que vous spécifiez dans l’état. Consultez le tableau dans DXCoreAdapterState pour plus d’informations sur toute exigence de mémoire tampon d’entrée pour un type d’état donné.

inputDataSize

Type : size_t

Taille, en octets, de la mémoire tampon d’entrée que vous allouez et fournissez dans inputData.

inputData [in]

Type : void*

Pointeur vers une mémoire tampon d’entrée que vous allouez dans votre application, contenant les informations d’état à définir pour l’élément d’état dont vous spécifiez le type d’état. Pour plus d’informations sur la configuration requise de la mémoire tampon d’entrée pour un type d’état donné, consultez le tableau dans DXCoreAdapterState .

Retours

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Valeur retournée	Description
DXGI_ERROR_DEVICE_REMOVED	L’adaptateur n’est plus dans un état valide.
DXGI_ERROR_INVALID_CALL	Le type d’état spécifié dans l’état n’est pas reconnu par ce système d’exploitation. Appelez IsSetStateSupported pour confirmer que la définition du type d’état est disponible pour cet adaptateur et ce système d’exploitation.
DXGI_ERROR_UNSUPPORTED	Le type d’état spécifié dans l’état n’est pas pris en charge par l’adaptateur. Appelez IsSetStateSupported pour confirmer que la définition du type d’état est disponible pour cet adaptateur et ce système d’exploitation.
E_INVALIDARG	Une taille de mémoire tampon insuffisante est fournie pour inputData (ou pour inputStateDetails où une mémoire tampon des détails d’état d’entrée est nécessaire).
E_POINTER	`nullptr` a été fourni pour inputData (ou pour inputStateDetails où une mémoire tampon des détails d’état d’entrée est nécessaire).

Voir aussi

IDXCoreAdapter, Référence DXCore, Utilisation de DXCore pour énumérer les adaptateurs