ID3D12InfoQueue::AddRetrievalFilterEntries method

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

Syntax

HRESULT AddRetrievalFilterEntries(
  D3D12_INFO_QUEUE_FILTER *pFilter
);

Parameters

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[] = { ..., ..., ... };
UINT 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 = sizeof(cats / sizeof(D3D12_MESSAGE_CATEGORY)); 
filter.AllowList.pCategoryList = cats;
filter.AllowList.NumSeverities = sizeof(sevs / sizeof(D3D12_MESSAGE_SEVERITY)); 
filter.AllowList.pSeverityList = sevs;
filter.AllowList.NumIDs = sizeof(ids) / sizeof(UINT);
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

   
Target Platform Windows
Header d3d12sdklayers.h

See Also

ID3D12InfoQueue