Metodo ID3D10Asynchronous::GetData (d3d10.h)

Ottenere i dati dalla GPU in modo asincrono.

Sintassi

HRESULT GetData(
  [out] void *pData,
  [in]  UINT DataSize,
  [in]  UINT GetDataFlags
);

Parametri

[out] pData

Tipo: void*

Indirizzo di memoria che riceverà i dati. Se NULL, GetData verrà usato solo per controllare lo stato. Il tipo di output dei dati dipende dal tipo di interfaccia asincrona. Vedere la sezione Osservazioni.

[in] DataSize

Tipo: UINT

Dimensioni dei dati da recuperare o 0. Questo valore può essere ottenuto con ID3D10Asynchronous::GetDataSize. Deve essere 0 quando pData è NULL.

[in] GetDataFlags

Tipo: UINT

Flag facoltativi. Può essere 0 o qualsiasi combinazione dei flag enumerati da D3D10_ASYNC_GETDATA_FLAG.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, i valori restituiti possibili sono i seguenti:

• S_FALSE
• DXGI_ERROR_DEVICE_REMOVED
• DXGI_ERROR_INVALID_CALL

Commenti

GetData recupera i dati raccolti tra le chiamate a ID3D10Asynchronous::Begin e ID3D10Asynchronous::End. Alcune query richiedono solo una chiamata a ID3D10Asynchronous::End , nel qual caso i dati restituiti da GetData sono accurati fino all'ultima chiamata a ID3D10Asynchronous::End (vedere l'interfaccia ID3D10Query).

Se DataSize è 0, GetData viene usato solo per controllare lo stato in cui un valore restituito di S_OK indica che i dati sono disponibili per assegnare a un'applicazione e un valore restituito di S_FALSE indica che i dati non sono ancora disponibili.

Non è possibile richiamare questa funzione su un predicato creato con il flag D3D10_QUERY_MISCFLAG_PREDICATEHINT.

Se l'interfaccia asincrona che chiama questa funzione è ID3D10Query Interface, viene applicata la tabella seguente.

Tipo di query	Tipo di dati di output	Supports Begin, metodo
D3D10_QUERY_EVENT	BOOL	NO
D3D10_QUERY_OCCLUSION	UINT64	YES
D3D10_QUERY_TIMESTAMP	UINT64	NO
D3D10_QUERY_TIMESTAMP_DISJOINT	D3D10_QUERY_DATA_TIMESTAMP_DISJOINT	YES
D3D10_QUERY_PIPELINE_STATISTICS	D3D10_QUERY_DATA_PIPELINE_STATISTICS	YES
D3D10_QUERY_OCCLUSION_PREDICATE	BOOL	YES
D3D10_QUERY_SO_STATISTICS	D3D10_QUERY_DATA_SO_STATISTICS	YES
D3D10_QUERY_SO_OVERFLOW_PREDICATE	BOOL	YES

 

Se l'interfaccia asincrona che chiama questa API è ID3D10Counter Interface, si applica quanto segue.

Tipo di contatore	Tipo di dati di output	Unità
D3D10_COUNTER_GPU_IDLE	FLOAT32	frazione di tempo
D3D10_COUNTER_VERTEX_PROCESSING	FLOAT32	frazione di tempo
D3D10_COUNTER_GEOMETRY_PROCESSING	FLOAT32	frazione di tempo
D3D10_COUNTER_PIXEL_PROCESSING	FLOAT32	frazione di tempo
D3D10_COUNTER_OTHER_GPU_PROCESSING	FLOAT32	frazione di tempo
D3D10_COUNTER_HOST_ADAPTER_BANDWIDTH_UTILIZATION	FLOAT32	frazione del massimo teorico
D3D10_COUNTER_LOCAL_VIDMEM_BANDWIDTH_UTILIZATION	FLOAT32	frazione del massimo teorico
D3D10_COUNTER_VERTEX_THROUGHPUT_UTILIZATION	FLOAT32	frazione del massimo teorico
D3D10_COUNTER_TRIANGLE_SETUP_THROUGHPUT_UTILIZATION	FLOAT32	frazione del massimo teorico
D3D10_COUNTER_FILLRATE_THROUGHPUT_UTILIZATION	FLOAT32	frazione del massimo teorico
D3D10_COUNTER_VS_MEMORY_LIMITED	FLOAT32	frazione di tempo
D3D10_COUNTER_VS_COMPUTATION_LIMITED	FLOAT32	frazione di tempo
D3D10_COUNTER_GS_MEMORY_LIMITED	FLOAT32	frazione di tempo
D3D10_COUNTER_GS_COMPUTATION_LIMITED	FLOAT32	frazione di tempo
D3D10_COUNTER_PS_MEMORY_LIMITED	FLOAT32	frazione di tempo
D3D10_COUNTER_PS_COMPUTATION_LIMITED	FLOAT32	frazione di tempo
D3D10_COUNTER_POST_TRANSFORM_CACHE_HIT_RATE	FLOAT32	frazione
D3D10_COUNTER_TEXTURE_CACHE_HIT_RATE	FLOAT32	frazione

 

Il valore restituito da un contatore D3D10_COUNTER_GPU_IDLE, D3D10_COUNTER_VERTEX_PROCESSING, D3D10_COUNTER_GEOMETRY_PROCESSING, D3D10_COUNTER_PIXEL_PROCESSING o D3D10_COUNTER_OTHER_GPU_PROCESSING può essere diverso a seconda del numero di contatori paralleli presenti in una scheda video e questi valori possono essere interpretati con l'equazione seguente:

Il numero di contatori paralleli che una scheda video ha è disponibile da NumDetectableParallelUnits in D3D10_COUNTER_INFO e può essere recuperato chiamando ID3D10Device::CheckCounterInfo.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	d3d10.h
Libreria	D3D10.lib

Vedi anche

Interfaccia ID3D10Asynchronous