Método IDXCoreAdapter::GetProperty
Recupera el valor de la propiedad de adaptador especificada. Antes de llamar a GetProperty para un tipo de propiedad, llame a IsPropertySupported para confirmar que el tipo de propiedad está disponible para este adaptador y sistema operativo (SO). Además, antes de llamar a GetProperty, llame a GetPropertySize para determinar el tamaño necesario del búfer en el que se va a recibir el valor de propiedad.
Sintaxis
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);
Parámetros
propiedad
Tipo: DXCoreAdapterProperty
Tipo de la propiedad cuyo valor desea recuperar. Consulta la tabla en DXCoreAdapterProperty para obtener más información sobre cada propiedad del adaptador.
bufferSize
Tipo: size_t
Tamaño, en bytes, del búfer de salida que asigne y proporcione en propertyData.
propertyData [out]
Tipo: void*
Puntero a un búfer de salida que se asigna en la aplicación y que la función rellena. Llame a GetPropertySize para determinar el tamaño que debe tener el búfer propertyData para una propiedad de adaptador determinada.
Devoluciones
Tipo: HRESULT
Si la función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de errorHRESULT.
Valor devuelto | Descripción |
---|---|
DXGI_ERROR_INVALID_CALL | Este sistema operativo (SO) no reconoce el tipo de propiedad especificado en la propiedad . Llame a IsPropertySupported para confirmar que el tipo de propiedad está disponible para este adaptador y sistema operativo (SO). |
DXGI_ERROR_UNSUPPORTED | El adaptador no admite el tipo de propiedad especificado en la propiedad . Llame a IsPropertySupported para confirmar que el tipo de propiedad está disponible para este adaptador y sistema operativo (SO). |
E_INVALIDARG | Se proporciona un tamaño de búfer insuficiente en propertyData. Llame a GetPropertySize para determinar el tamaño que debe tener el búfer propertyData para una propiedad de adaptador determinada. |
E_POINTER | nullptr se proporcionó para propertyData. |
Observaciones
Puede llamar a GetProperty en un adaptador que ya no sea válido; la función no producirá un error como resultado de eso. Esta función se agota el búfer propertyData antes de rellenarlo.
Consulte también
IDXCoreAdapter, Referencia de DXCore, Uso de DXCore para enumerar adaptadores
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de