IDMLBindingTable::BindOutputs-Methode (directml.h)

Artikel
02/28/2024

Bindet eine Gruppe von Ressourcen als Ausgabe tensoren.

Bei der Bindung für einen kompilierten Operator muss die Anzahl der Bindungen genau mit der Anzahl der Eingaben des Operators übereinstimmen, einschließlich optionaler Tensoren. Dies kann anhand der Operatorbeschreibung bestimmt werden, die zum Erstellen des Operators verwendet wird. Wenn zu viele oder zu wenige Bindungen bereitgestellt werden, wird das Gerät entfernt. Für optionale Tensoren können Sie DML_BINDING_TYPE_NONE verwenden, um "keine Bindung" anzugeben. Andernfalls muss der Bindungstyp mit dem Tensortyp übereinstimmen, als der Operator erstellt wurde.

Bei Operatorinitialisierern sind die Ausgabebindungen die persistenten Ressourcen jedes Operators, die in der Reihenfolge angegeben werden, in der die Operatoren beim Erstellen oder Zurücksetzen des Initialisierers angegeben wurden. Wenn ein bestimmter Operator keine persistente Ressource erfordert, sollten Sie eine leere Bindung in diesem Slot nachweisen.

Um die Bindung aller Eingaberessourcen aufzuheben, geben Sie einen rangeCount-Wert von 0 und den Wert nullptr für Bindungen an.

Die beschreibbaren Bereiche von zwei Ausgabe tensoren dürfen sich nicht miteinander überlappen. Der "beschreibbare Bereich" eines gebundenen Ausgabepuffers ist als Startoffset des Pufferbereichs bis zum TotalTensorSizeInBytes definiert, wie in der Tensorbeschreibung angegeben.

Alle Puffer, die als Ausgabe gebunden werden, müssen über den Heaptyp D3D12_HEAP_TYPE_DEFAULT verfügen.

Syntax

void BindOutputs(
                 UINT                   bindingCount,
  [in, optional] const DML_BINDING_DESC *bindings
);

Parameter

bindingCount

Typ: UINT

Dieser Parameter bestimmt die Größe des Bindungsarrays (sofern angegeben).

[in, optional] bindings

Typ: const DML_BINDING_DESC*

Ein optionaler Zeiger auf ein konstantes Array von DML_BINDING_DESC , das Beschreibungen der zu bindenden Tensorressourcen enthält.

Rückgabewert

Keine

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	directml.h
Bibliothek	DirectML.lib
DLL	DirectML.dll

Weitere Informationen

Bindung in DirectML

IDMLBindingTable

Share via