> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # SetDescriptorHeaps > Cambia los montones de descriptores enlazados actualmente que están asociados a una lista de comandos. Cambia los montones de descriptores enlazados actualmente que están asociados a una lista de comandos. ## Sintaxis ```cpp theme={null} void SetDescriptorHeaps( UINT NumDescriptorHeaps, ID3D12DescriptorHeap* ppDescriptorHeaps ) ``` ### Parámetros *NumDescriptorHeaps*\ Tipo: UINT Número de montones de descriptores que se van a enlazar. *ppDescriptorHeaps*\ Tipo: \[in] **[ID3D12DescriptorHeap](/reference/graphics/d3d12/interfaces/id3d12descriptorheap/id3d12descriptorheap_public)**\* Un puntero a una matriz de objetos [ID3D12DescriptorHeap](/reference/graphics/d3d12/interfaces/id3d12descriptorheap/id3d12descriptorheap_public) para los montones que se van a establecer en la lista de comandos. Solo puede enlazar montones de descriptores de tipo [**D3D12\_DESCRIPTOR\_HEAP\_TYPE\_CBV\_SRV\_UAV**](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setdescriptorheaps_public) y [**D3D12\_DESCRIPTOR\_HEAP\_TYPE\_SAMPLER**](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setdescriptorheaps_public). Solo se puede establecer un montón de descriptores de cada tipo a la vez, lo que significa que se puede establecer un máximo de 2 montones (uno de muestreador y uno de CBV/SRV/UAV) a la vez. ### Valor devuelto Tipo: void Ninguno. ## Comentarios Se puede llamar a **SetDescriptorHeaps** en un lote (bundle), pero los montones de descriptores del lote deben coincidir con el montón de descriptores de la lista de comandos que realiza la llamada. Para obtener más información sobre las restricciones de los lotes, consulte [Creación y grabación de listas de comandos y lotes](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/recording-command-lists-and-bundles). La llamada anula todos los montones establecidos anteriormente. Como máximo, se puede establecer un montón de cada tipo visible para el sombreador en la llamada. Cambiar los montones de descriptores puede provocar un vaciado de la canalización en algunos tipos de hardware. Por este motivo, se recomienda usar un único montón visible para el sombreador de cada tipo y establecerlo una vez por fotograma, en lugar de cambiar con regularidad los montones de descriptores enlazados. En su lugar, use [**ID3D12Device::CopyDescriptors**](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_copydescriptors_public) e [**ID3D12Device::CopyDescriptorsSimple**](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_copydescriptorssimple_public) para copiar los descriptores necesarios desde montones opacos para el sombreador al único montón visible para el sombreador según sea necesario durante la representación. ## Ejemplos El ejemplo [D3D12Bundles](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/working-samples) usa **ID3D12GraphicsCommandList::SetDescriptorHeaps** de la siguiente manera: ```cpp theme={null} void D3D12Bundles::PopulateCommandList(FrameResource* pFrameResource) { // Command list allocators can only be reset when the associated // command lists have finished execution on the GPU; apps should use // fences to determine GPU execution progress. ThrowIfFailed(m_pCurrentFrameResource->m_commandAllocator->Reset()); // However, when ExecuteCommandList() is called on a particular command // list, that command list can then be reset at any time and must be before // re-recording. ThrowIfFailed(m_commandList->Reset(m_pCurrentFrameResource->m_commandAllocator.Get(), m_pipelineState1.Get())); // Set necessary state. m_commandList->SetGraphicsRootSignature(m_rootSignature.Get()); ID3D12DescriptorHeap* ppHeaps[] = { m_cbvSrvHeap.Get(), m_samplerHeap.Get() }; m_commandList->SetDescriptorHeaps(_countof(ppHeaps), ppHeaps); m_commandList->RSSetViewports(1, &m_viewport); m_commandList->RSSetScissorRects(1, &m_scissorRect); // Indicate that the back buffer will be used as a render target. m_commandList->ResourceBarrier(1, &CD3DX12_RESOURCE_BARRIER::Transition(m_renderTargets[m_frameIndex].Get(), D3D12_RESOURCE_STATE_PRESENT, D3D12_RESOURCE_STATE_RENDER_TARGET)); CD3DX12_CPU_DESCRIPTOR_HANDLE rtvHandle(m_rtvHeap->GetCPUDescriptorHandleForHeapStart(), m_frameIndex, m_rtvDescriptorSize); CD3DX12_CPU_DESCRIPTOR_HANDLE dsvHandle(m_dsvHeap->GetCPUDescriptorHandleForHeapStart()); m_commandList->OMSetRenderTargets(1, &rtvHandle, FALSE, &dsvHandle); // Record commands. const float clearColor[] = { 0.0f, 0.2f, 0.4f, 1.0f }; m_commandList->ClearRenderTargetView(rtvHandle, clearColor, 0, nullptr); m_commandList->ClearDepthStencilView(m_dsvHeap->GetCPUDescriptorHandleForHeapStart(), D3D12_CLEAR_FLAG_DEPTH, 1.0f, 0, 0, nullptr); if (UseBundles) { // Execute the prebuilt bundle. m_commandList->ExecuteBundle(pFrameResource->m_bundle.Get()); } else { // Populate a new command list. pFrameResource->PopulateCommandList(m_commandList.Get(), m_pipelineState1.Get(), m_pipelineState2.Get(), m_currentFrameResourceIndex, m_numIndices, &m_indexBufferView, &m_vertexBufferView, m_cbvSrvHeap.Get(), m_cbvSrvDescriptorSize, m_samplerHeap.Get(), m_rootSignature.Get()); } // Indicate that the back buffer will now be used to present. m_commandList->ResourceBarrier(1, &CD3DX12_RESOURCE_BARRIER::Transition(m_renderTargets[m_frameIndex].Get(), D3D12_RESOURCE_STATE_RENDER_TARGET, D3D12_RESOURCE_STATE_PRESENT)); ThrowIfFailed(m_commandList->Close()); } ``` Consulte [Código de ejemplo en la referencia de D3D12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/notes-on-example-code). ## Requisitos **Encabezado:** d3d12\_xs.h o d3d12\_x.h\ **Biblioteca:** d3d12\_xs.lib o d3d12\_x.lib\ **Plataformas compatibles**: consolas XBOX Series y familia XBOX One ## Consulte también [Montones de descriptores](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/descriptor-heaps) [ID3D12GraphicsCommandList](/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs) ## Related topics - [ClearUnorderedAccessViewFloat](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewfloat_public.md) - [ClearUnorderedAccessViewUint](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewuint_public.md) - [CreateDescriptorHeap](/es/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createdescriptorheap_public.md) - [ID3D12DescriptorHeap](/es/reference/graphics/d3d12/interfaces/id3d12descriptorheap/id3d12descriptorheap_public.md) - [D3D12_GPU_DESCRIPTOR_HANDLE](/es/reference/graphics/d3d12/structs/d3d12_gpu_descriptor_handle_public.md)