ID3D12Device5::CreateMetaCommand method (d3d12.h)

Creates an instance of the specified meta command.

Syntax

HRESULT CreateMetaCommand(
  [in]           REFGUID    CommandId,
  [in]           UINT       NodeMask,
  [in, optional] const void *pCreationParametersData,
  [in]           SIZE_T     CreationParametersDataSizeInBytes,
                 REFIID     riid,
  [out]          void       **ppMetaCommand
);

Parameters

[in] CommandId

Type: REFIID

A reference to the globally unique identifier (GUID) of the meta command that you wish to instantiate.

[in] NodeMask

Type: UINT

For single-adapter operation, set this to zero. If there are multiple adapter nodes, set a bit to identify the node (one of the device's physical adapters) to which the meta command applies. Each bit in the mask corresponds to a single node. Only one bit must be set. See Multi-adapter systems.

[in, optional] pCreationParametersData

Type: const void*

An optional pointer to a constant structure containing the values of the parameters for creating the meta command.

[in] CreationParametersDataSizeInBytes

Type: SIZE_T

A SIZE_T containing the size of the structure pointed to by pCreationParametersData, if set, otherwise 0.

riid

Type: REFIID

A reference to the globally unique identifier (GUID) of the interface that you wish to be returned in ppMetaCommand. This is expected to be the GUID of ID3D12MetaCommand.

[out] ppMetaCommand

Type: void**

A pointer to a memory block that receives a pointer to the meta command. This is the address of a pointer to an ID3D12MetaCommand, representing the meta command created.

Return value

Type: HRESULT

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

Requirements

See also

ID3D12Device5