D3DDDIARG_CREATERESOURCE2 Struktur (d3dukmdt.h)

Artikel
02/23/2024

Enthält Informationen zum Erstellen einer Ressource. Wird von Windows Display Driver Model (WDDM) 1.2 und höher für Benutzermodusanzeigetreiber verwendet.

Syntax

typedef struct _D3DDDIARG_CREATERESOURCE2 {
  [in]     D3DDDIFORMAT                   Format;
  [in]     D3DDDI_POOL                    Pool;
  [in]     D3DDDIMULTISAMPLE_TYPE         MultisampleType;
  [in]     UINT                           MultisampleQuality;
  [in]     const D3DDDI_SURFACEINFO       *pSurfList;
  [in]     UINT                           SurfCount;
  [in]     UINT                           MipLevels;
  [in]     UINT                           Fvf;
  [in]     D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  [in]     D3DDDI_RATIONAL                RefreshRate;
  [in/out] HANDLE                         hResource;
  [in]     D3DDDI_RESOURCEFLAGS           Flags;
  [in]     D3DDDI_ROTATION                Rotation;
  [in]     D3DDDI_RESOURCEFLAGS2          Flags2;
} D3DDDIARG_CREATERESOURCE2;

Member

[in] Format

Ein Wert vom Typ D3DDDIFORMAT , der das Format der Ressourcen angibt.

[in] Pool

Ein Wert vom Typ D3DDDI_POOL , der den Typ des Speicherpools angibt, aus dem die Ressourcen erstellt werden.

[in] MultisampleType

Ein Wert vom Typ D3DDDIMULTISAMPLE_TYPE , der die Anzahl von Beispielen für eine Oberfläche mit mehreren Stichproben angibt. Wenn die Oberfläche nicht mehrere Stichproben enthält, ist dieser Wert D3DDDIMULTISAMPLE_NONE (0).

[in] MultisampleQuality

Die Qualitätsebene des Renderns von Beispielen auf einer Oberfläche mit mehreren Stichproben. Das Qualitätsniveau muss eine Zahl von 0 bis 7 sein, die eine Qualitätsstufe von 1 bis 8 darstellt.

Beachten Sie, dass die Oberfläche auch dann, wenn es sich nicht um mehrere Stichproben handelt (d. a. wenn D3DDDIMULTISAMPLE_NONE in MultisampleType angegeben ist), dennoch eine Qualitätsebene aufweisen kann, die größer als 1 ist (dies wird mithilfe einer Zahl größer als 0 angegeben).

[in] pSurfList

Ein Array von D3DDDI_SURFACEINFO Strukturen für die Liste der zu erstellenden Oberflächen (oder anderen Ressourcentypen).

[in] SurfCount

Die Anzahl der Ressourcen in dem Array, die vom pSurfList-Element angegeben wird.

[in] MipLevels

Die Anzahl der MIP-Zuordnungsebenen für die Ressourcen.

[in] Fvf

Das FVF-Format für Vertexpuffer.

[in] VidPnSourceId

Die nullbasierte Identifikationsnummer der Videoquelle in einem Pfad einer VidPN-Topologie (Video Present Network), auf der die primäre Oberfläche erstellt wird (wenn die Ressource eine primäre Oberfläche enthält).

[in] RefreshRate

Eine D3DDDI_RATIONAL Struktur, die die Aktualisierungsrate angibt, mit der die Ressource verwendet wird. Dieser Member ist nur anwendbar, wenn es sich bei der Ressource um die primäre Oberfläche handelt und das Bitfeldflag MatchGdiPrimary im Flags-Element nicht festgelegt ist. Wenn außerdem das InterlacedRefresh-Bitfeldflag in Flags festgelegt ist, bestimmt der Benutzermodusanzeigetreiber, dass die Aktualisierungsrate verschachtelt ist (andernfalls progressiv).

[in/out] hResource

Ein Handle für die Ressource. Bei der Eingabe an die CreateResource2-Funktion gibt hResource das Handle an, das der Treiber verwenden soll, wenn er in die Microsoft Direct3D-Runtime zurückruft.

Der Treiber generiert ein eindeutiges Handle und übergibt es zurück an die Direct3D-Runtime. Bei der Ausgabe der CreateResource2-Funktion gibt hResource das Handle an, das die Direct3D-Runtime in nachfolgenden Treiberaufrufen verwenden soll, um die Ressource zu identifizieren.

[in] Flags

Eine D3DDDI_RESOURCEFLAGS-Struktur , die den Typ der zu erstellenden Ressourcen identifiziert. Beachten Sie, dass für einige Bitfeldflags in D3DDDI_RESOURCEFLAGS zusätzliche Bitfeldflags festgelegt werden müssen.

[in] Rotation

Ein D3DDDI_ROTATION typisierter Wert, der die Ausrichtung der Ressource angibt.

Betrachten Sie beispielsweise, dass der Benutzermodusanzeigetreiber eine Anforderung erhält, dass eine 480x640-Oberfläche um 90 Grad gedreht werden soll (D3DDDI_ROTATION_90). Der Treiber sollte die Oberfläche zu Scanzwecken im Modus 640x480 zuordnen. Beim Rendern auf der Oberfläche sollte der Treiber die Drehung um 90 Grad ausführen.

Andere Ausrichtungen als D3DDDI_ROTATION_IDENTITY werden nur festgelegt, wenn das Primäre Bitfeldflag ebenfalls im Flags-Element festgelegt ist.

[in] Flags2

Eine D3DDDI_RESOURCEFLAGS2-Struktur , die den Typ der zu erstellenden Ressourcen identifiziert. Beachten Sie, dass für einige Bitfeldflags in D3DDDI_RESOURCEFLAGS2 zusätzliche Bitfeldflags festgelegt werden müssen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Kopfzeile	d3dukmdt.h (einschließlich D3dukmdt.h, D3dkmddi.h)