IDMLBindingTable::Reset method (directml.h)

Resets the binding table to wrap a new range of descriptors, potentially for a different operator or initializer. This allows dynamic reuse of the binding table.

Resetting a binding table doesn't modify any previous bindings created by the table. Because of this, it is safe to reset the binding table immediately after supplying it to IDMLCommandRecorder::RecordDispatch, even if that work has not yet completed execution on the GPU, so long as the underlying descriptors remain valid.

See IDMLDevice::CreateBindingTable for more information on the parameters supplied to this method.

Syntax

HRESULT Reset(
  [in, optional] const DML_BINDING_TABLE_DESC *desc
);

Parameters

[in, optional] desc

Type: const DML_BINDING_TABLE_DESC*

An optional pointer to a DML_BINDING_TABLE_DESC containing the binding table parameters. This may be nullptr, indicating an empty binding table.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Target Platform Windows
Header directml.h
Library DirectML.lib
DLL DirectML.dll

See also

Binding in DirectML

IDMLBindingTable