PFND3D10DDI_QUERYBEGIN Rückruffunktion (d3d10umddi.h)
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) |