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