D3D10DDIARG_CREATERESOURCE-Struktur (d3d10umddi.h)

Artikel
02/22/2024

D3D10DDIARG_CREATERESOURCE enthält die Argumente, die von PFND3D10DDI_CREATERESOURCE zum Erstellen einer Ressource verwendet werden.

Syntax

typedef struct D3D10DDIARG_CREATERESOURCE {
  [in]      const D3D10DDI_MIPINFO            *pMipInfoList;
  [in]      const D3D10_DDIARG_SUBRESOURCE_UP *pInitialDataUP;
  [in]      D3D10DDIRESOURCE_TYPE             ResourceDimension;
  [in]      UINT                              Usage;
  [in]      UINT                              BindFlags;
  [in]      UINT                              MapFlags;
  [in]      UINT                              MiscFlags;
  [in]      DXGI_FORMAT                       Format;
  [in]      DXGI_SAMPLE_DESC                  SampleDesc;
  [in]      UINT                              MipLevels;
  [in]      UINT                              ArraySize;
  [in, out] DXGI_DDI_PRIMARY_DESC             *pPrimaryDesc;
} D3D10DDIARG_CREATERESOURCE;

Member

[in] pMipInfoList

Ein Array von D3D10DDI_MIPINFO Strukturen, das Dimensionen für MIP-Ebenen enthält. Bei Ressourcenformaten, bei denen nicht direkt auf ein einzelnes Pixel oder Texel mit einer Byteadresse verwiesen werden kann, sind die Abmessungen der physischen Ressource in der Regel größer oder gleich den Texeldimensionen, um die erforderlichen Platzanforderungen zu erfüllen. Um beispielsweise eine vollständig getippte BC1-Textur2D zu erstellen, Wenn die detaillierteste Ebene 8x8 ist, ist das pMipInfoList-Array : { { 8, 8, 1, 8, 1 }, { 4, 4, 1, 4, 1 }, { 2, 2, 1, 4, 4, 4, 1 }, { 1, 1, 1, 4, 4} }.

[in] pInitialDataUP

Ein Array von D3D10_DDIARG_SUBRESOURCE_UP Strukturen, das Initialisierungsinformationen für die Liste der Unterressourcen der Ressource bereitstellt.

[in] ResourceDimension

Ein Wert vom Typ D3D10DDIRESOURCE_TYPE , der den Ressourcentyp und die Dimensionalität angibt.

[in] Usage

Ein Wert vom Typ D3D10_DDI_RESOURCE_USAGE , der angibt, wie die Ressource verwendet wird.

[in] BindFlags

Ein gültiger bitweiser OR mit D3D10_DDI_RESOURCE_BIND_FLAG Werten, der angibt, wie die Ressource gebunden ist.

[in] MapFlags

Ein Wert vom Typ D3D10_DDI_MAP , der die Zugriffsebene angibt, die der Ressource zugeordnet werden soll.

[in] MiscFlags

Ein gültiger bitweiser OR mit D3D10_DDI_RESOURCE_MISC_FLAG Werten, der verschiedene Informationen über die Ressource angibt.

[in] Format

Ein Wert vom Typ DXGI_FORMAT , der das Pixelformat der Ressource angibt.

[in] SampleDesc

Ein Wert vom Typ DXGI_SAMPLE_DESC , der die Anzahl der Stichproben und die Qualität der Ressource beschreibt.

[in] MipLevels

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

[in] ArraySize

Die Anzahl der Arrayelemente für eine 2D-Textur oder eine 1D-Textur. ArraySize muss für eine Cubetextur auf 6 festgelegt werden.

Wenn der Treiber ab Windows 8 einen Stereobackpuffer erstellen muss, sollte er diesen Member auf den Wert 2 festlegen.

[in, pPrimaryDesc

Ein Zeiger auf eine DXGI_DDI_PRIMARY_DESC-Struktur , die eine Ressource beschreibt, die als primäre Ressource verwendet wird.

Die Microsoft Direct3D-Runtime legt pPrimaryDesc nur auf einen Wert ungleich NULL fest, wenn das D3D10_DDI_BIND_PRESENT Bit im BindFlags-Element festgelegt ist. Selbst wenn D3D10_DDI_BIND_PRESENT festgelegt ist, legt die Laufzeit pPrimaryDesc jedoch nicht immer auf nicht NULL fest. Wenn pPrimaryDesc auf nicht NULL festgelegt wird, wird angegeben, dass die erstellte Ressource von der Runtime als primäre Ressource (d. h. die Ressource wird auf der Anzeige gescannt) und in flipartigen aktuellen Vorgängen verwendet.

Der Anzeigetreiber für den Benutzermodus kann das DXGI_DDI_PRIMARY_DRIVER_FLAG_NO_SCANOUT-Flag im DriverFlags-Member von DXGI_DDI_PRIMARY_DESC zurückgeben, um zu verhindern, dass die Laufzeit aktuelle Vorgänge im Flip-Stil ausführt.

Wenn pPrimaryDesc auf NULL festgelegt ist, verwendet die Laufzeit die erstellte Ressource in vorhandenen Vorgängen im Kopierstil (Bitblockübertragung).