D3DKMDT_GDISURFACETYPE-Enumeration (d3dkmdt.h)

Artikel
05/18/2024

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 verfügt über eine einstufige Textur. Sie ist für die CPU nicht sichtbar, und der Videospeicher-Manager erstellt ihn 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 das 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 cachekonshärenten GPU-Blendensegment sein. Sie wird als Quelloberfläche in hardwarebeschleunigten GDI-Vorgängen verwendet. Es wird als Zieloberfläche in Bitblt-GDI-Vorgängen (nur kopiergeschützt) verwendet. Sein Pitch muss vom Display-Miniporttreiber zurückgegeben werden. Sein Pitchwert und seine Oberflächenadresse müssen am Wert des AlignmentShift-Members 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-Bitbltvorgängen (nur kopiergeschützt) verwendet.
`D3DKMDT_GDISURFACE_LOOKUPTABLE` Gibt an, dass die Oberfläche über die folgenden Eigenschaften verfügt: Sie ist für die CPU nicht sichtbar. Es 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 >von 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 cachekonshärenten GPU-Blendensegment sein. Sein Pitchwert und seine Oberflächenadresse müssen am Wert des AlignmentShift-Members 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. Wird ab Windows 8 unterstützt.
`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 ihn als freigegebene adapterübergreifende Oberfläche. Seine Tonhöhe muss vom Anzeigeminiporttreiber im Pitch-Element der D3DKMDT_GDISURFACEDATA-Struktur zurückgegeben werden. Die Neigung und 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 Pitch- und Höhe für die adapterübergreifende Ressource zurückgibt. Diese Konstanten werden in D3dukmdt.h definiert. Wird ab Windows 8.1 unterstützt.
`D3DKMDT_GDISURFACE_TEXTURE_CPUVISIBLE_CROSSADAPTER` Ist für das System reserviert. Verwenden Sie diesen Wert nicht in Ihrem Treiber. Wird ab Windows 8.1 unterstützt.