Share via

IDirect3D9::CheckDeviceFormatConversion-Methode (d3d9.h)

  • Artikel

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

Weitere Informationen

ColorFill

IDirect3D9