IDXCoreAdapter：：GetProperty 方法

擷取指定之配接器屬性的值。 呼叫 屬性類型的 GetProperty 之前，請先呼叫 IsPropertySupported 以確認這個介面卡和作業系統可以使用屬性類型， (OS) 。 此外，在呼叫 GetProperty之前，請呼叫 GetPropertySize 來判斷要接收屬性值之緩衝區的必要大小。

語法

virtual HRESULT STDMETHODCALLTYPE GetProperty(
  DXCoreAdapterProperty property,
  size_t bufferSize,
  _Out_writes_bytes_(bufferSize) void *propertyData) = 0;

template <class T>
HRESULT GetProperty( 
  DXCoreAdapterProperty property,
  _Out_writes_bytes_(sizeof(T)) T *propertyData);

參數

屬性

類型： DXCoreAdapterProperty

您想要擷取其值的屬性型別。 如需每個配接器屬性的詳細資訊，請參閱 DXCoreAdapterProperty 中的表格。

bufferSize

類型： size_t

您在 propertyData中配置和提供的輸出緩衝區大小，以位元組為單位。

propertyData [out]

類型： void*

您在應用程式中配置的輸出緩衝區指標，且函式會填入。 呼叫 GetPropertySize 以判斷 propertyData 緩衝區應針對指定配接器屬性的大小。

傳回

類型： HRESULT

如果函式成功，它會 傳回S_OK。 否則，它會傳回 HRESULT錯誤碼。

傳回值	描述
DXGI_ERROR_INVALID_CALL	這個作業系統無法辨識 屬性 中指定的屬性類型 (OS) 。 呼叫 IsPropertySupported 以確認此屬性類型適用于此介面卡和作業系統 (作業系統) 。
DXGI_ERROR_UNSUPPORTED	配接器不支援 屬性中指定的屬性 類型。 呼叫 IsPropertySupported 以確認此屬性類型適用于此介面卡和作業系統 (作業系統) 。
E_INVALIDARG	propertyData中提供緩衝區大小不足。 呼叫 GetPropertySize 以判斷 propertyData 緩衝區應針對指定配接器屬性的大小。
E_POINTER	nullptr 已針對 propertyData提供。

備註

您可以在不再有效的配接器上呼叫 GetProperty —函式不會因為失敗而失敗。 此函式會在填入屬性之前將 propertyData 緩衝區清空。

另請參閱

IDXCoreAdapter、 DXCore 參考、 使用 DXCore 列舉配接器