ID3D11DeviceContext::RSGetViewports-Methode (d3d11.h)

Artikel
08/22/2023

Ruft das Array von Viewports ab, die an die Rasterizerphase gebunden sind.

Syntax

void RSGetViewports(
  [in, out]       UINT           *pNumViewports,
  [out, optional] D3D11_VIEWPORT *pViewports
);

Parameter

[in, out] pNumViewports

Typ: UINT*

Ein Zeiger auf eine Variable, die bei der Eingabe die Anzahl von Viewports (Bereiche von 0 bis D3D11_VIEWPORT_AND_SCISSORRECT_OBJECT_COUNT_PER_PIPELINE) im pViewports-Array angibt; in der Ausgabe enthält die Variable die tatsächliche Anzahl von Viewports, die an die Rasterizerphase gebunden sind. Wenn pViewportsNULL ist, füllt RSGetViewports die Variable mit der Anzahl der aktuell gebundenen Viewports aus.

Hinweis In einigen Versionen des Windows SDK löst ein Debuggerät eine Ausnahme aus, wenn der Eingabewert in der Variablen, auf die pNumViewports verweist, größer als D3D11_VIEWPORT_AND_SCISSORRECT_OBJECT_COUNT_PER_PIPELINE ist, auch wenn pViewportsNULL ist. Die reguläre Runtime ignoriert den Wert in der Variablen, auf die pNumViewports zeigt, wenn pViewportsNULL ist. Dieses Verhalten eines Debuggeräts kann in einer zukünftigen Version des Windows SDK korrigiert werden.

[out, optional] pViewports

Typ: D3D11_VIEWPORT*

Ein Array von D3D11_VIEWPORT Strukturen für die Viewports, die an die Rasterizerphase gebunden sind. Wenn die Anzahl der Viewports (in der Variablen, auf die pNumViewports verweist) größer ist als die tatsächliche Anzahl der aktuell gebundenen Viewports, enthalten nicht verwendete Elemente des Arrays 0. Informationen dazu, wie die Viewportgröße von der Gerätefeatureebene abhängt, die sich zwischen Direct3D 11 und Direct3D 10 geändert hat, finden Sie unter D3D11_VIEWPORT.

Rückgabewert

Keine

Bemerkungen

Windows Phone 8: Diese API wird unterstützt.

Anforderungen


Zielplattform	Windows
Kopfzeile	d3d11.h
Bibliothek	D3D11.lib

Weitere Informationen

ID3D11DeviceContext

Freigeben über