D3DDDIARG_CREATERESOURCE Struktur (d3dukmdt.h)

Artikel
02/26/2024

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)

Weitere Informationen

CreateResource

D3DDDIFORMAT

D3DDDIMULTISAMPLE_TYPE