PFND3D10DDI_DESTROYSAMPLER Rückruffunktion (d3d10umddi.h)

  • Artikel

Die DestroySampler-Funktion zerstört das angegebene Samplerobjekt. Das Samplerobjekt kann nur zerstört werden, wenn es derzeit nicht an ein Anzeigegerät gebunden ist.

Syntax

PFND3D10DDI_DESTROYSAMPLER Pfnd3d10ddiDestroysampler;

void Pfnd3d10ddiDestroysampler(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D10DDI_HSAMPLER unnamedParam2
)
{...}

Parameter

unnamedParam1

hDevice [in]

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

unnamedParam2

hSampler [in]

Ein Handle für die privaten Daten des Treibers für das zu zerstörende Samplerobjekt. Die Microsoft Direct3D-Runtime gibt den Speicherbereich frei, den sie zuvor für das Objekt zugewiesen hat. Daher kann der Treiber nicht mehr auf diesen Speicherbereich zugreifen.

Rückgabewert

Keine

Bemerkungen

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

Für den Treiber sollte mit Ausnahme von D3DDDIERR_DEVICEREMOVED kein Fehler auftreten. 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 DestroySampler beeinträchtigt (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 (include D3d10umddi.h)

Weitere Informationen

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb