ID3D10Asynchronous::GetData-Methode (d3d10.h)

Abrufen von Daten aus der GPU asynchron.

Syntax

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

Parameter

[out] pData

Typ: void*

Adresse des Arbeitsspeichers, der die Daten empfängt. Bei NULL wird GetData nur verwendet, um status zu überprüfen. Der Typ der Datenausgabe hängt vom Typ der asynchronen Schnittstelle ab. Siehe Hinweise.

[in] DataSize

Typ: UINT

Größe der abzurufenden Daten oder 0. Dieser Wert kann mit ID3D10Asynchronous::GetDataSize abgerufen werden. Muss 0 sein, wenn pDataNULL ist.

[in] GetDataFlags

Typ: UINT

Optionale Flags. Kann 0 oder eine beliebige Kombination der von D3D10_ASYNC_GETDATA_FLAG aufgezählten Flags sein.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls sind folgende Rückgabewerte möglich:

• S_FALSE
• DXGI_ERROR_DEVICE_REMOVED
• DXGI_ERROR_INVALID_CALL

Hinweise

GetData ruft die Daten ab, die zwischen Aufrufen von ID3D10Asynchronous::Begin und ID3D10Asynchronous::End gesammelt wurden. Für bestimmte Abfragen ist nur ein Aufruf von ID3D10Asynchronous::End erforderlich. In diesem Fall sind die von GetData zurückgegebenen Daten bis zum letzten Aufruf von ID3D10Asynchronous::End genau (siehe ID3D10Query-Schnittstelle).

Wenn DataSize 0 ist, wird GetData nur verwendet, um status zu überprüfen, bei dem ein Rückgabewert von S_OK angibt, dass Daten für eine Anwendung verfügbar sind, und ein Rückgabewert von S_FALSE gibt an, dass Daten noch nicht verfügbar sind.

Es ist ungültig, diese Funktion für ein Prädikat aufzurufen, das mit dem Flag D3D10_QUERY_MISCFLAG_PREDICATEHINT erstellt wurde.

Wenn die asynchrone Schnittstelle, die diese Funktion aufruft , ID3D10Query Interface ist, gilt die folgende Tabelle.

Abfragetyp	Ausgabedatentyp	Unterstützt die Begin-Methode
D3D10_QUERY_EVENT	BOOL	Nein
D3D10_QUERY_OCCLUSION	UINT64	YES
D3D10_QUERY_TIMESTAMP	UINT64	Nein
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

 

Wenn die asynchrone Schnittstelle, die diese API aufruft , ID3D10Counter Interface ist, gilt Folgendes.

Indikatortyp	Ausgabedatentyp	Einheiten
D3D10_COUNTER_GPU_IDLE	FLOAT32	Zeitanteil
D3D10_COUNTER_VERTEX_PROCESSING	FLOAT32	Zeitanteil
D3D10_COUNTER_GEOMETRY_PROCESSING	FLOAT32	Zeitanteil
D3D10_COUNTER_PIXEL_PROCESSING	FLOAT32	Zeitanteil
D3D10_COUNTER_OTHER_GPU_PROCESSING	FLOAT32	Zeitanteil
D3D10_COUNTER_HOST_ADAPTER_BANDWIDTH_UTILIZATION	FLOAT32	Bruch des theoretischen Maximums
D3D10_COUNTER_LOCAL_VIDMEM_BANDWIDTH_UTILIZATION	FLOAT32	Bruch des theoretischen Maximums
D3D10_COUNTER_VERTEX_THROUGHPUT_UTILIZATION	FLOAT32	Bruch des theoretischen Maximums
D3D10_COUNTER_TRIANGLE_SETUP_THROUGHPUT_UTILIZATION	FLOAT32	Bruch des theoretischen Maximums
D3D10_COUNTER_FILLRATE_THROUGHPUT_UTILIZATION	FLOAT32	Bruch des theoretischen Maximums
D3D10_COUNTER_VS_MEMORY_LIMITED	FLOAT32	Zeitanteil
D3D10_COUNTER_VS_COMPUTATION_LIMITED	FLOAT32	Zeitanteil
D3D10_COUNTER_GS_MEMORY_LIMITED	FLOAT32	Zeitanteil
D3D10_COUNTER_GS_COMPUTATION_LIMITED	FLOAT32	Zeitanteil
D3D10_COUNTER_PS_MEMORY_LIMITED	FLOAT32	Zeitanteil
D3D10_COUNTER_PS_COMPUTATION_LIMITED	FLOAT32	Zeitanteil
D3D10_COUNTER_POST_TRANSFORM_CACHE_HIT_RATE	FLOAT32	fraction
D3D10_COUNTER_TEXTURE_CACHE_HIT_RATE	FLOAT32	fraction

 

Der von einem D3D10_COUNTER_GPU_IDLE, D3D10_COUNTER_VERTEX_PROCESSING, D3D10_COUNTER_GEOMETRY_PROCESSING, D3D10_COUNTER_PIXEL_PROCESSING oder D3D10_COUNTER_OTHER_GPU_PROCESSING Zähler zurückgegebene Wert kann sich je nach Anzahl paralleler Indikatoren in einem Video-Karte unterscheiden, und diese Werte können mit der folgenden Gleichung interpretiert werden:

Die Anzahl der parallelen Indikatoren, die ein Video Karte hat, ist über NumDetectableParallelUnits in D3D10_COUNTER_INFO verfügbar und kann durch Aufrufen von ID3D10Device::CheckCounterInfo abgerufen werden.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	d3d10.h
Bibliothek	D3D10.lib

Weitere Informationen

ID3D10Asynchrone Schnittstelle