D3DDDIARG_CREATERESOURCE Struktur (d3dukmdt.h)
Die D3DDDIARG_CREATERESOURCE-Struktur enthält Informationen zum Erstellen einer Ressource.
Syntax
typedef struct _D3DDDIARG_CREATERESOURCE {
[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;
} D3DDDIARG_CREATERESOURCE;
Member
[in] Format
Ein D3DDDIFORMAT typisierter Wert, der das Format der Ressourcen angibt.
[in] Pool
Ein D3DDDI_POOL typisierter Wert, der den Typ des Speicherpools angibt, aus dem die Ressourcen erstellt werden.
[in] MultisampleType
Ein D3DDDIMULTISAMPLE_TYPE typisierter Wert, der die Anzahl der Beispiele 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 CreateResource-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 CreateResource-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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Kopfzeile | d3dukmdt.h (einschließlich D3dumddi.h, D3dkmddi.h) |