ID3D12InfoQueue::AddRetrievalFilterEntries method (d3d12sdklayers.h)

Add storage filters to the top of the retrieval-filter stack.

Syntax

HRESULT AddRetrievalFilterEntries(
  [in] D3D12_INFO_QUEUE_FILTER *pFilter
);

Parameters

[in] pFilter

Type: D3D12_INFO_QUEUE_FILTER*

Array of retrieval filters.

Return value

Type: HRESULT

This method returns one of the Direct3D 12 Return Codes.

Remarks

The following code example shows how to use this method:

 
D3D12_MESSAGE_CATEGORY cats[] = { ..., ..., ... };
D3D12_MESSAGE_SEVERITY sevs[] = { ..., ..., ... };
D3D12_MESSAGE_ID ids[] = { ..., ..., ... };

D3D12_INFO_QUEUE_FILTER filter;
memset( &filter, 0, sizeof(filter) );

// To set the type of messages to allow, 
// set filter.AllowList as follows:
filter.AllowList.NumCategories = _countof(cats);
filter.AllowList.pCategoryList = cats;
filter.AllowList.NumSeverities = _countof(sevs);
filter.AllowList.pSeverityList = sevs;
filter.AllowList.NumIDs = _countof(ids);
filter.AllowList.pIDList = ids;

// To set the type of messages to deny, set filter.DenyList 
// similarly to the preceding filter.AllowList.

// The following single call sets all of the preceding information.
hr = infoQueue->AddRetrievalFilterEntries( &filter );
 

Requirements

Requirement Value
Target Platform Windows
Header d3d12sdklayers.h

See also

ID3D12InfoQueue