ID2D1CommandList::Close method (d2d1_1.h)

Instructs the command list to stop accepting commands so that you can use it as an input to an effect or in a call to ID2D1DeviceContext::DrawImage. You should call the method after it has been attached to an ID2D1DeviceContext and written to but before the command list is used.

Syntax

HRESULT Close();

Return value

Type: HRESULT

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

HRESULT	Description
S_OK	No error occurred.
D2DERR_WRONG_STATE	Close has already been called on the command list.

 

Note  If the device context associated with the command list has an error, the command list returns the same error.

 

Remarks

This method returns D2DERR_WRONG_STATE if it has already been called on the command list. If an error occurred on the device context during population, the method returns that error. Otherwise, the method returns S_OK.

If the Close method returns an error, any future use of the command list results in the same error.

Requirements

Requirement	Value
Minimum supported client	Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]
Minimum supported server	Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform	Windows
Header	d2d1_1.h
DLL	D2d1.dll

See also

ID2D1CommandList