D3DKMDT_GDISURFACETYPE-Enumeration (d3dkmdt.h)

Die D3DKMDT_GDISURFACETYPE-Enumeration gibt den Typ der sperrbaren Oberfläche an, die vom Desktopfenster-Manager (DWM) für die Umleitung verwendet wird.

Syntax

typedef enum _D3DKMDT_GDISURFACETYPE {
  D3DKMDT_GDISURFACE_INVALID,
  D3DKMDT_GDISURFACE_TEXTURE,
  D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE,
  D3DKMDT_GDISURFACE_STAGING,
  D3DKMDT_GDISURFACE_LOOKUPTABLE,
  D3DKMDT_GDISURFACE_EXISTINGSYSMEM,
  D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE,
  D3DKMDT_GDISURFACE_TEXTURE_CROSSADAPTER,
  D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE_CROSSADAPTER
} D3DKMDT_GDISURFACETYPE;

Konstanten

 
D3DKMDT_GDISURFACE_INVALID
Der Treiber sollte diesen Wert nicht sehen.
D3DKMDT_GDISURFACE_TEXTURE
Gibt an, dass die Oberfläche über die folgenden Eigenschaften verfügt:



  • Es hat eine 1-Ebenen-Textur.



  • Sie ist für die CPU nicht sichtbar, und der Videospeicher-Manager erstellt sie als freigegebene Oberfläche.



  • Es wird von einem Benutzermodustreiber geöffnet und während der DWM-Komposition als Textur verwendet.



  • Es wird von einem Benutzermodustreiber als Renderziel für DirectX-Rendering verwendet.



  • Sie wird als Quell- oder Zieloberfläche in hardwarebeschleunigten GDI-Vorgängen verwendet.


D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE
Gibt an, dass die Oberfläche über die folgenden Eigenschaften verfügt:



  • Es ist für die CPU sichtbar und wird von der CPU umfassend verwendet. Die Zuordnung muss ein lineares Format und in einem cachekohärenten GPU-Blendensegment sein.



  • Sie wird als Quelloberfläche in hardwarebeschleunigten GDI-Vorgängen verwendet.



  • Sie wird als Zieloberfläche in Bitblt-GDI-Vorgängen (nur Kopie) verwendet.



  • Sein Pitch muss vom Display-Miniporttreiber zurückgegeben werden.



  • Der Tonhöhenwert und die Oberflächenadresse müssen am Wert des AlignmentShift-Elements der DXGK_PRESENTATIONCAPS-Struktur (d. h. DXGK_DRIVERCAPS-PresentationCaps.AlignmentShift>) ausgerichtet werden.


D3DKMDT_GDISURFACE_STAGING
Gibt an, dass die Oberfläche über die folgenden Eigenschaften verfügt:



  • Sie ist für die CPU nicht sichtbar.



  • Sie wird als Quell- oder Zieloberfläche in hardwarebeschleunigten GDI-Vorgängen verwendet.



  • Sie wird als Quell- oder Zieloberfläche in GDI-Bitblt-Vorgängen (nur Kopie) verwendet.


D3DKMDT_GDISURFACE_LOOKUPTABLE
Gibt an, dass die Oberfläche über die folgenden Eigenschaften verfügt:



  • Sie ist für die CPU nicht sichtbar.



  • Sie wird nur während der Verarbeitung von Befehlen verwendet, die von ClearTypeBlend und OpCode angegeben werden. DXGK_GDIOP_BITBLT (nur kopiergeschützte) Member der DXGK_RENDERKM_COMMAND-Struktur .



  • Das Format wird durch den D3DDDIFMT_A8-Wert der D3DDDIFORMAT-Enumeration definiert.



  • Die Gamma-Lookupzuordnung wird einmal erstellt und ändert sich nach der Initialisierung nie. Die Zuordnung wird in D3DDDIFMT_A8 Format initialisiert, indem ein DXGK_RENDERKM_COMMAND-Opcode.DXGK_GDIOP_BITBLT-Befehl >auf einer D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE-Oberfläche ausgegeben wird.


D3DKMDT_GDISURFACE_EXISTINGSYSMEM
Gibt an, dass die Oberfläche über die folgenden Eigenschaften verfügt:



  • Sie ist für die CPU sichtbar. Die Zuordnung muss ein lineares Format und in einem cachekohärenten GPU-Blendensegment sein.



  • Der Tonhöhenwert und die Oberflächenadresse müssen am Wert des AlignmentShift-Elements der DXGK_PRESENTATIONCAPS-Struktur (d. h. DXGK_DRIVERCAPS-PresentationCaps.AlignmentShift>) ausgerichtet werden.



  • Die Surface-Adresse wird an den Treiber übergeben.



  • Dieser Wert wird auf die gleiche Weise wie der D3DKMDT_GDISURFACE_STAGING_CPUVISIBLE-Wert verwendet.


D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE
Ist für das System reserviert. Verwenden Sie diesen Wert nicht in Ihrem Treiber.

Unterstützt ab Windows 8.
D3DKMDT_GDISURFACE_TEXTURE_CROSSADAPTER
Gibt an, dass die Oberfläche über die folgenden Eigenschaften verfügt:



  • Sie ist für die CPU nicht sichtbar, und der Videospeicher-Manager erstellt sie als freigegebene adapterübergreifende Oberfläche.



  • Seine Tonhöhe muss vom Display-Miniporttreiber im Pitch-Element der D3DKMDT_GDISURFACEDATA-Struktur zurückgegeben werden.



  • Der Pitch und die Höhe müssen die erforderliche Ausrichtung für die adapterübergreifende Ressource aufweisen. Sie können die D3DKMT_CROSS_ADAPTER_RESOURCE_PITCH_ALIGNMENT und D3DKMT_CROSS_ADAPTER_RESOURCE_HEIGHT_ALIGNMENT Konstanten verwenden, um zu überprüfen, ob der Treiber die richtige Tonhöhe und Höhe für die adapterübergreifende Ressource zurückgibt. Diese Konstanten werden in D3dukmdt.h definiert.



Unterstützt ab Windows 8.1.
D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE_CROSSADAPTER
Ist für das System reserviert. Verwenden Sie diesen Wert nicht in Ihrem Treiber.

Unterstützt ab Windows 8.1.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 7 und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile d3dkmdt.h

Weitere Informationen

D3DDDIFORMAT

D3DKMDT_GDISURFACEDATA

DXGK_DRIVERCAPS

DXGK_PRESENTATIONCAPS

DXGK_RENDERKM_COMMAND