IDXCoreAdapter :: GetPropertySize, méthode

Pour une propriété de l’adaptateur spécifiée, récupère la taille de la mémoire tampon, en octets, requise pour un appel à GetProperty. Avant d’appeler GetPropertySize pour un type de propriété, appelez IsPropertySupported pour confirmer que le type de propriété est disponible pour cet adaptateur et le système d’exploitation.

Syntaxe

virtual HRESULT STDMETHODCALLTYPE GetPropertySize(
  DXCoreAdapterProperty property,
  _Out_ size_t *bufferSize) = 0;

Paramètres

propriété

Type : DXCoreAdapterProperty

Type de la propriété dont vous souhaitez récupérer la taille, en octets.

bufferSize [out]

Type : size_t *

Pointeur vers une valeur size_t . La fonction déréférence le pointeur et affecte à la valeur la taille, en octets, de la mémoire tampon de sortie que vous devez allouer et passer comme argument PropertyData dans votre appel à GetProperty.

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_INVALID_CALL Le type de propriété spécifié dans la propriété n’est pas reconnu par ce système d’exploitation. Appelez IsPropertySupported pour confirmer que le type de propriété est disponible pour cet adaptateur et le système d’exploitation.
DXGI_ERROR_UNSUPPORTED Le type de propriété spécifié dans la propriété n’est pas pris en charge par l’adaptateur. Appelez IsPropertySupported pour confirmer que le type de propriété est disponible pour cet adaptateur et le système d’exploitation.
E_POINTER nullptr a été fourni pour bufferSize.

Remarques

Vous pouvez appeler GetPropertySize sur un adaptateur qui n’est plus valide — . la fonction ne peut pas échouer.

Voir aussi

IDXCoreAdapter, référence dxcore, utilisation de dxcore pour énumérer les adaptateurs