UpdateSubresources-Funktion

Updates Unterressourcen sollten alle Unterressourcenarrays aufgefüllt werden, in der Regel durch Aufrufen von ID3D12Device::GetCopyableFootprints.

Syntax

UINT64 inline UpdateSubresources(
  _In_       ID3D12GraphicsCommandList          *pCmdList,
  _In_       ID3D12Resource                     *pDestinationResource,
  _In_       ID3D12Resource                     *pIntermediate,
  _In_       UINT                               FirstSubresource,
  _In_       UINT                               NumSubresources,
             UINT64                             RequiredSize,
  _In_ const D3D12_PLACED_SUBRESOURCE_FOOTPRINT *pLayouts,
  _In_ const UINT                               *pNumRows,
  _In_ const UINT64                             *pRowSizesInBytes,
  _In_ const D3D12_SUBRESOURCE_DATA             *pSrcData
);

Parameter

pCmdList [in]

Typ: ID3D12GraphicsCommandList*

Die Befehlsliste als Zeiger auf eine ID3D12GraphicsCommandList.

pDestinationResource [in]

Typ: ID3D12Resource*

Die Zielressource als Zeiger auf eine ID3D12Resource.

pIntermediate [in]

Typ: ID3D12Resource*

Die Zwischenressource als Zeiger auf eine ID3D12Resource.

FirstSubresource [in]

Typ: UINT

Der Index der ersten Unterressource in der Ressource. Der Bereich der gültigen Werte beträgt 0 bis D3D12_REQ_SUBRESOURCES.

NumSubresources [in]

Typ: UINT

Die Anzahl der Unterressourcen in der Ressource. Der Bereich der gültigen Werte beträgt 0 bis (D3D12_REQ_SUBRESOURCES – FirstSubresource).

RequiredSize

Typ: UINT64

Die erforderliche Größe in Bytes für das Update.

pLayouts [in]

Typ: const D3D12_PLACED_SUBRESOURCE_FOOTPRINT*

Zeiger auf ein Array (der Länge NumSubresources) von Zeigern auf die Strukturen, die die Beschreibung und Platzierung der Unterressourcen der Ressource enthalten.

pNumRows [in]

Typ: const UINT*

Zeiger auf ein Array (der Länge NumSubresources) von UINTS, das die Anzahl der Zeilen für jede Unterressource enthält.

pRowSizesInBytes [in]

Typ: const UINT64*

Zeiger auf ein Array (der Länge NumSubresources) von UINTS, das die Größe jeder Zeile in Byte enthält.

pSrcData [in]

Typ: const D3D12_SUBRESOURCE_DATA*

Zeiger auf ein Array (der Länge NumSubresources) von Zeigern auf D3D12_SUBRESOURCE_DATA Strukturen, die Beschreibungen der für die Aktualisierung verwendeten Unterressourcendaten enthalten.

Rückgabewert

Typ: UINT64

Die Größe des Cookies in Bytes.

Anforderungen

Siehe auch

Funktionen des Hilfsprogramms für D3D12

Unterressourcen