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 "Gebäude".
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 Abfrageobjekt, das gestartet werden soll.
Rückgabewert
Nichts
Bemerkungen
Der Treiber kann die pfnSetErrorCb Rückruffunktion 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 implizierten Anfang.
Die Microsoft Direct3D-Laufzeit kann QueryBegin- nicht für ein Prädikat aufrufen, das derzeit über einen Aufruf der SetPredication--Funktion an die Pipeline gebunden ist.
Der Treiber sollte keinen Fehler haben, mit Ausnahme von D3DDDIERR_DEVICEREMOVED. Wenn der Treiber daher einen Fehler außer D3DDDIERR_DEVICEREMOVED übergibt, bestimmt die Direct3D-Laufzeit in einem Aufruf der funktion pfnSetErrorCb, dass der Fehler kritisch ist. Selbst wenn das Gerät entfernt wurde, ist der Treiber nicht erforderlich, um D3DDDIERR_DEVICEREMOVED zurückzugeben; Wenn die Geräteentfernung jedoch den Vorgang QueryBegin beeinträchtigt (was normalerweise nicht geschehen sollte), kann der Treiber D3DDDIERR_DEVICEREMOVED zurückgeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3d10umddi.h (include D3d10umddi.h) |