Funzione IddCxSwapChainGetPhysicallyContiguousAddress (iddcx.h)

Articolo
02/29/2024

IddCxSwapChainGetPhysicallyContiguousAddress recupera l'indirizzo fisico della superficie attualmente acquisita della swapchain specificata.

Sintassi

HRESULT IddCxSwapChainGetPhysicallyContiguousAddress(
  [in]  IDDCX_SWAPCHAIN  SwapChainObject,
  [out] PHYSICAL_ADDRESS *pSurfaceAddresss
);

Parametri

[in] SwapChainObject

Oggetto IDDCX_SWAPCHAIN usato per eseguire query sull'indirizzo fisico della superficie attualmente acquisita.

[out] pSurfaceAddresss

Puntatore a una variabile PHYSICAL_ADDRESS compilata con l'indirizzo fisico di una superficie o nullptr.

Valore restituito

IddCxSwapChainGetPhysicallyContiguousAddress restituisce S_OK sull'esito positivo e indica un puntatore fisico valido in pSurface. Se non è stato possibile soddisfare la richiesta iniziale di allocare le primarie nella memoria fisicamente contigua, questo metodo restituirà E_NOINTERFACE. Se una superficie non è stata attualmente acquisita o se pSurface è nullptr, questo metodo restituirà E_INVALIDARG.

Commenti

IddCxSwapChainGetPhysicallyContiguousAddress cerca la superficie attualmente acquisita della swapchain specificata ed esegue prima un'attesa per eventuali comandi di rendering in sospeso. Una volta completata l'attesa, recupera l'indirizzo fisico della superficie se la richiesta iniziale ha avuto esito positivo e quindi esegue uno scaricamento della cache e l'invalidazione nell'intervallo contenente la superficie.