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;
Angehörige
[in] Format
Ein D3DDDIFORMAT-typed-Wert, der das Format der Ressourcen angibt.
[in] Pool
Ein D3DDDI_POOL-typed-Wert, der den Typ des Arbeitsspeicherpools angibt, aus dem die Ressourcen erstellt werden.
[in] MultisampleType
Ein D3DDDIMULTISAMPLE_TYPE-typisierter Wert, der die Anzahl der Stichproben für eine mehrsame Oberfläche angibt. Wenn die Oberfläche nicht mehrere Stichproben enthält, ist dieser Wert D3DDDIMULTISAMPLE_NONE (0).
[in] MultisampleQuality
Die Qualitätsebene der Renderingbeispiele in einer Mehrfachbeispieleoberfläche. Das Qualitätsniveau muss eine Zahl zwischen 0 und 7 sein, die ein Qualitätsniveau von 1 bis 8 darstellt.
Beachten Sie, dass selbst wenn die Oberfläche nicht mit mehreren Stichproben versehen ist (d. r., wenn D3DDDIMULTISAMPLE_NONE in MultisampleType-angegeben ist) weiterhin eine Qualitätsstufe aufweisen kann, die größer als 1 ist (die mit einer Zahl größer als 0 angegeben wird).
[in] pSurfList
Ein Array von D3DDDI_SURFACEINFO Strukturen für die Liste der zu erstellenden Oberflächen (oder andere Ressourcentypen).
[in] SurfCount
Die Anzahl der Ressourcen im Array, die durch das pSurfList Member 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 Netzwerktopologie (VidPN), 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. Dieses Element gilt nur, wenn die Ressource die primäre Oberfläche ist und das MatchGdiPrimary- Bitfeld-Flag nicht im Flags Member festgelegt ist. Wenn die InterlacedRefresh Bitfeld-Flag in Flagsfestgelegt ist, bestimmt der Anzeigetreiber für den Benutzermodus, dass die Aktualisierungsrate interleaviert ist (andernfalls progressive).
[in/out] hResource
Ein Handle für die Ressource. Bei Eingaben an die CreateResource--Funktion gibt hResource- den Handle an, den der Treiber verwenden soll, wenn er wieder in die Microsoft Direct3D-Laufzeit aufruft.
Der Treiber generiert ein eindeutiges Handle und übergibt es an die Direct3D-Laufzeit zurück. Bei der Ausgabe der CreateResource--Funktion gibt hResource- das Handle an, das die Direct3D-Laufzeit in nachfolgenden Treiberaufrufen zum Identifizieren der Ressource verwenden soll.
[in] Flags
Eine D3DDDI_RESOURCEFLAGS Struktur, die den Typ der zu erstellenden Ressourcen identifiziert. Beachten Sie, dass einige der Bitfeld-Flags in D3DDDI_RESOURCEFLAGS erfordern, dass auch zusätzliche Bitfeld-Flags festgelegt werden.
[in] Rotation
Ein D3DDDI_ROTATION-typed-Wert, der die Ausrichtung der Ressource identifiziert.
Denken Sie beispielsweise daran, dass der Benutzermodusanzeigetreiber eine Anforderung für eine 480x640-Oberfläche erhält, um 90 Grad gedreht zu werden (D3DDDI_ROTATION_90). Der Treiber sollte die Oberfläche für Scanzwecke im 640x480-Modus zuordnen. Beim Rendern auf der Oberfläche sollte der Treiber die Drehung von 90 Grad ausführen.
Andere Ausrichtungen als D3DDDI_ROTATION_IDENTITY werden nur festgelegt, wenn das Primäre Bitfeldflagge auch im Flags Member festgelegt ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Header- | d3dukmdt.h (einschließlich D3dumddi.h, D3dkmddi.h) |