PFND3D10DDI_SETTEXTFILTERSIZE Rückruffunktion (d3d10umddi.h)

Die SetTextFilterSize-Funktion legt die Breite und Höhe des monochromen Faltungsfilters fest.

Syntax

PFND3D10DDI_SETTEXTFILTERSIZE Pfnd3d10ddiSettextfiltersize;

void Pfnd3d10ddiSettextfiltersize(
  D3D10DDI_HDEVICE unnamedParam1,
  UINT unnamedParam2,
  UINT unnamedParam3
)
{...}

Parameter

unnamedParam1

hDevice [in]

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

unnamedParam2

Breite [in]

Die Breite des monochromen Faltungsfilters. Die Breite kann zwischen 1 und 7 Texel sein.

unnamedParam3

Höhe [in]

Die Höhe des monochromen Faltungsfilters. Die Höhe kann von 1 bis 7 Texel sein.

Rückgabewert

Keine

Bemerkungen

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

Die Anzahl von Beispielen, die für die Dimensionen eines Kernels erforderlich sind, ist tatsächlich (Breite + 1) x (Höhe + 1), was von 4 bis 64 Samples ausgehen kann. Diese Einstellungen gelten für alle Sampler, die für die Verwendung des D3D10_DDI_FILTER_TEXT_1BIT-Filters aus der D3D10_DDI_FILTER-Enumeration konfiguriert sind.

SetTextFilterSize stellt sicher, dass die werte, die in den Parametern Width und Height angegeben werden, sich im Bereich befinden. Die Standardwerte für Breite und Höhe sind zunächst 1. Der Treiber muss diese Standardwerte während der Geräteerstellung festlegen.

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 Vorgang von SetTextFilterSize 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

D3D10DDI_DEVICEFUNCS

D3D10_DDI_FILTER

pfnSetErrorCb