Método ID3D12DebugCommandList1::AssertResourceState (d3d12sdklayers.h)
Valida que el estado especificado coincida con el estado del subrecurso, suponiendo que el estado del subrecurso especificado se conozca durante la grabación de una lista de comandos (por ejemplo, el recurso se ha realizado anteriormente en la misma grabación de lista de comandos). Si el estado aún no se conoce, este método establece el estado conocido para una validación posterior en la misma grabación de lista de comandos.
BOOL AssertResourceState(
[in] ID3D12Resource *pResource,
UINT Subresource,
UINT State
);
[in] pResource
Tipo: ID3D12Resource*
Especifica id3D12Resource que se va a comprobar.
Subresource
Tipo: UINT
Índice del subrecurso que se va a comprobar. Esto se puede establecer en un índice o D3D12_RESOURCE_BARRIER_ALL_SUBRESOURCES.
State
Tipo: UINT
Especifica el estado que se va a comprobar. Puede ser una o varias marcas de D3D12_RESOURCE_STATES o juntas.
Tipo: BOOL
Este método devuelve true si el estado de seguimiento del recurso o subrecurso coincide con el estado especificado; en caso contrario, false.
Dado que la ejecución de listas de comandos se produce algún tiempo después de la grabación, el estado de un recurso a menudo no se puede conocer durante la grabación de la lista de comandos. AssertResourceState ofrece a un desarrollador de aplicaciones la capacidad de imponer un estado asumido en un recurso o subrecurso en un punto de grabación fijo en una lista de comandos.
A menudo, el estado de un recurso o subrecurso se puede conocer debido a una barrera anterior o a una barrera inferida por uso (por ejemplo, se usó en una llamada anterior a CopyBufferRegion) durante la grabación de la lista de comandos. En tales casos , AssertResourceState puede generar un mensaje de depuración si el estado especificado no coincide con el estado conocido o asumido.
Esta API es solo para la validación de depuración y no afecta al estado real en tiempo de ejecución o GPU del recurso.
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | d3d12sdklayers.h |