IDirect3D9::CheckDeviceFormatConversion-Methode (d3d9.h)
Testet das Gerät, um festzustellen, ob es die Konvertierung von einem Anzeigeformat in ein anderes unterstützt.
Syntax
HRESULT CheckDeviceFormatConversion(
[in] UINT Adapter,
[in] D3DDEVTYPE DeviceType,
[in] D3DFORMAT SourceFormat,
[in] D3DFORMAT TargetFormat
);
Parameter
[in] Adapter
Typ: UINT
Ordnungszahl des Anzeigeadapters. D3DADAPTER_DEFAULT ist immer der primäre Grafikkarte. Diese Methode gibt D3DERR_INVALIDCALL zurück, wenn dieser Wert der Anzahl der Grafikkarten im System entspricht oder überschreitet.
[in] DeviceType
Typ: D3DDEVTYPE
Gerätetyp: Member des D3DDEVTYPE aufgezählten Typs.
[in] SourceFormat
Typ: D3DFORMAT
Quelladapterformat. Member des D3DFORMAT aufgezählten Typs.
[in] TargetFormat
Typ: D3DFORMAT
Zieladapterformat. Member des D3DFORMAT aufgezählten Typs.
Rückgabewert
Typ: HRESULT
Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, wird der Rückgabewert D3DERR_INVALIDCALL. Die -Methode gibt D3DERR_NOTAVAILABLE zurück, wenn die Hardware keine Konvertierung zwischen den beiden Formaten unterstützt.
Hinweise
Die Verwendung von CheckDeviceType zum Testen der Kompatibilität zwischen einem Hintergrundpuffer, der sich vom Anzeigeformat unterscheidet, gibt entsprechende Werte zurück. Dies bedeutet, dass der Anruf die Gerätefunktionen widerspiegelt. Wenn das Gerät nicht im angeforderten Backpufferformat gerendert werden kann, gibt der Aufruf weiterhin D3DERR_NOTAVAILABLE zurück. Wenn das Gerät im Format rendern kann, die Farbkonvertierung jedoch nicht durchführen kann, wird der Rückgabewert ebenfalls D3DERR_NOTAVAILABLE. Anwendungen können die Hardwareunterstützung für die Präsentation selbst ermitteln, indem sie CheckDeviceFormatConversion aufrufen. Es wird keine Softwareemulation für die Farbkonvertierung selbst angeboten.
CheckDeviceFormatConversion kann auch verwendet werden, um zu bestimmen, welche Kombinationen von Quelloberflächenformaten und Zieloberflächenformaten in Aufrufen von StretchRect zulässig sind.
Die Farbkonvertierung ist auf die folgenden Quell- und Zielformate beschränkt.
- Das Quellformat muss ein FOURCC-Format oder ein gültiges Zurückpufferformat sein. Eine Liste dieser Formate finden Sie unter FourCC-Formate und BackBuffer oder Anzeigeformate.
- Das Zielformat muss eines der folgenden Formate ohne Vorzeichen sein:
D3DFMT_X1R5G5B5 D3DFMT_A1R5G5B5 D3DFMT_R5G6B5 D3DFMT_R8G8B8 D3DFMT_X8R8G8B8 D3DFMT_A8R8G8B8 D3DFMT_A2R10G10B10 D3DFMT_A16B16G16R16 D3DFMT_A2B10G10R10 D3DFMT_A8B8G8R8 D3DFMT_X8B8G8R8 D3DFMT_A16B16G16R16F D3DFMT_A32B32G32R32F
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | d3d9.h (einschließlich D3D9.h) |
| Bibliothek | D3D9.lib |