PFND3D10DDI_CREATESAMPLER Rückruffunktion (d3d10umddi.h)
Die CreateSampler-Funktion erstellt einen Sampler.
Syntax
PFND3D10DDI_CREATESAMPLER Pfnd3d10ddiCreatesampler;
void Pfnd3d10ddiCreatesampler(
D3D10DDI_HDEVICE unnamedParam1,
const D3D10_DDI_SAMPLER_DESC *unnamedParam2,
D3D10DDI_HSAMPLER unnamedParam3,
D3D10DDI_HRTSAMPLER unnamedParam4
)
{...}
Parameter
unnamedParam1
hDevice [in]
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pSamplerDesc [in]
Ein Zeiger auf eine D3D10_DDI_SAMPLER_DESC Struktur, die die Parameter beschreibt, die der Benutzermodusanzeigetreiber zum Erstellen eines Samplers verwendet.
unnamedParam3
hSampler [in]
Ein Handle für die privaten Daten des Treibers für den Sampler. Der Treiber gibt die Größe des Arbeitsspeicherbereichs in Bytes zurück, die die Microsoft Direct3D-Runtime für die privaten Daten aus einem Aufruf der CalcPrivateSamplerSize-Funktion des Treibers zuordnen muss. Das Handle ist eigentlich nur ein Zeiger auf einen Bereich des Arbeitsspeichers, dessen Größe der Treiber angefordert hat. Der Treiber verwendet diesen Bereich des Arbeitsspeichers, um interne Datenstrukturen zu speichern, die sich auf das Samplerobjekt beziehen.
unnamedParam4
hRTSampler [in]
Ein Handle für den Sampler, das der Treiber bei jedem Aufruf in die Direct3D-Runtime verwenden sollte.
Rückgabewert
Keine
Bemerkungen
Der Treiber kann die Rückruffunktion pfnSetErrorCb verwenden, um einen Fehlercode festzulegen.
Der Treiber kann E_OUTOFMEMORY (wenn der Treiber nicht genügend Arbeitsspeicher hat) oder D3DDDIERR_DEVICEREMOVED (wenn das Gerät entfernt wurde) in einem Aufruf der pfnSetErrorCb-Funktion übergeben. Die Direct3D-Runtime bestimmt, dass alle anderen Fehler kritisch sind. Wenn der Treiber Fehler, einschließlich D3DDDIERR_DEVICEREMOVED, übergibt, ermittelt die Direct3D-Runtime, dass das Handle ungültig ist. Daher ruft die Runtime die DestroySampler-Funktion nicht auf, um das Handle zu zerstören, das der hSampler-Parameter angibt.
Der Anzeigetreiber für den Benutzermodus muss nicht mehr als 4.096 eindeutige Instanzen von Samplerobjekten gleichzeitig auf einem Gerät erstellen.
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) |