PFND3D10DDI_QUERYBEGIN Rückruffunktion (d3d10umddi.h)

Artikel
02/26/2024

Die QueryBegin-Funktion markiert den Anfang einer Sequenz von Grafikbefehlen für eine Abfrage und übergibt die Abfrage in den Zustand "Building".

Syntax

PFND3D10DDI_QUERYBEGIN Pfnd3d10ddiQuerybegin;

void Pfnd3d10ddiQuerybegin(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HQUERY unnamedParam2
)
{...}

Parameter

unnamedParam1

hDevice [in]

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

hQuery [in]

Ein Handle für das zu beginnende Abfrageobjekt.

Rückgabewert

Keine

Bemerkungen

Der Treiber kann die Rückruffunktion pfnSetErrorCb verwenden, um einen Fehlercode festzulegen.

Der Treiber ist nicht erforderlich, um die QueryBegin-Funktion für einen D3D10DDI_QUERY_EVENT- oder D3D10DDI_QUERY_TIMESTAMP-Abfragevorgang zu unterstützen. Ein solcher Abfragevorgang hat einen impliziten Anfang.

Die Microsoft Direct3D-Runtime kann QueryBegin nicht für ein Prädikat aufrufen, das derzeit über einen Aufruf der SetPredication-Funktion an die Pipeline gebunden ist.

Für den Treiber sollte kein Fehler auftreten, mit Ausnahme von D3DDDIERR_DEVICEREMOVED. Wenn der Treiber bei einem Aufruf der PfnSetErrorCb-Funktion einen Fehler mit Ausnahme von D3DDDIERR_DEVICEREMOVED übergibt, ermittelt die Direct3D-Runtime daher, dass der Fehler kritisch ist. Selbst wenn das Gerät entfernt wurde, muss der Treiber nicht D3DDDIERR_DEVICEREMOVED zurückgeben. Wenn die Geräteentfernung jedoch den Betrieb von QueryBegin beeinträchtigt hat (was normalerweise nicht geschehen sollte), kann der Treiber D3DDDIERR_DEVICEREMOVED zurückgeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	d3d10umddi.h (einschließlich D3d10umddi.h)

Weitere Informationen