IDXCoreAdapter :: SetState, méthode

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 le 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. Consultez le tableau dans DXCoreAdapterState pour plus d’informations sur chaque type d’état de l’adaptateur.

inputStateDetailsSize

Type : size_t

Taille, en octets, de la mémoire tampon des détails de l’état d’entrée que vous pouvez également allouer et fournir 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 relatives à votre demande requises pour le genre d’État que vous spécifiez dans État. Consultez le tableau dans DXCoreAdapterState pour plus d’informations sur les exigences en matière 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 dans État. Consultez le tableau dans DXCoreAdapterState pour plus d’informations sur la spécification de la mémoire tampon d’entrée pour un type d’État donné.

Retours

Type : HRESULT

Si la fonction est réussie, elle retourne S_OK. Sinon, elle retourne un code d’erreurHRESULT.

Valeur retournée Description
DXGI_ERROR_DEVICE_REMOVED L’état de l’adaptateur n’est plus valide.
DXGI_ERROR_INVALID_CALL Le genre 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 le système d’exploitation.
DXGI_ERROR_UNSUPPORTED Le genre 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 le système d’exploitation.
E_INVALIDARG Une taille de mémoire tampon insuffisante est fournie pour inputData (ou pour inputStateDetails où un tampon de détails d’état d’entrée est nécessaire).
E_POINTER nullptr a été fourni pour inputData (ou pour inputStateDetails où un tampon de 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