IDirect3D9::EnumAdapterModes-Methode (d3d9.h)

  • Artikel

Fragt das Gerät ab, um zu bestimmen, ob der angegebene Adapter das angeforderte Format und den anzeigemodus unterstützt. Diese Methode kann in einer Schleife verwendet werden, um alle verfügbaren Adaptermodi aufzulisten.

Syntax

HRESULT EnumAdapterModes(
  [in]  UINT           Adapter,
  [in]  D3DFORMAT      Format,
  [in]  UINT           Mode,
  [out] D3DDISPLAYMODE *pMode
);

Parameter

[in] Adapter

Typ: UINT

Ordnungszahl, die die zu enumerierende Grafikkarte angibt. 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] Format

Typ: D3DFORMAT

Zulässige Pixelformate. Siehe Hinweise.

[in] Mode

Typ: UINT

Stellt den Anzeigemodusindex dar, bei dem es sich um eine ganze Zahl ohne Vorzeichen zwischen 0 und dem von GetAdapterModeCount minus 1 zurückgegebenen Wert handelt.

[out] pMode

Typ: D3DDISPLAYMODE*

Ein Zeiger auf den verfügbaren Anzeigemodus vom Typ D3DDISPLAYMODE. Siehe Hinweise.

Rückgabewert

Typ: HRESULT

  • Wenn das Gerät auf diesem Adapter verwendet werden kann, wird D3D_OK zurückgegeben.
  • Wenn der Adapter die Anzahl der Grafikkarten im System gleich oder überschreitet, wird D3DERR_INVALIDCALL zurückgegeben.
  • Wenn ein Surface-Format nicht unterstützt wird oder die Hardwarebeschleunigung für die angegebenen Formate nicht verfügbar ist, wird D3DERR_NOTAVAILABLE zurückgegeben.

Hinweise

Eine Anwendung stellt einen Anzeigemodus und ein Format an EnumAdapterModes bereit, der einen Anzeigemodus zurückgibt. Diese Methode kann in einer Schleife verwendet werden, um alle verfügbaren Anzeigemodi aufzulisten.

Die Anwendung gibt ein Format an, und die Enumeration ist auf die Anzeigemodi beschränkt, die genau dem Format entsprechen (Alpha wird ignoriert). Zulässige Formate (die Member von D3DFORMAT sind):

  • D3DFMT_A1R5G5B5
  • D3DFMT_A2R10G10B10
  • D3DFMT_A8R8G8B8
  • D3DFMT_R5G6B5
  • D3DFMT_X1R5G5B5
  • D3DFMT_X8R8G8B8
Darüber hinaus behandelt EnumAdapterModes die Pixelformate 565 und 555 als gleichwertig und gibt die richtige Version zurück. Der Unterschied kommt nur ins Spiel, wenn die Anwendung den Rückpuffer sperrt und es ein explizites Flag gibt, das die Anwendung festlegen muss, um dies zu erreichen.

Anforderungen

   
Zielplattform Windows
Kopfzeile d3d9.h (einschließlich D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3D9