D3DDDIARG_CREATERESOURCE2 Struktur (d3dukmdt.h)
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) |