Функция IddCxSwapChainInSystemMemory (iddcx.h)

  • Статья

IddCxSwapChainInSystemMemory проверяет, находятся ли буферы для цепочки буферов в системной памяти.

Синтаксис

HRESULT IddCxSwapChainInSystemMemory(
  [in]  IDDCX_SWAPCHAIN SwapChainObject,
  [out] BOOL            *pInSystemMemory
);

Параметры

[in] SwapChainObject

Объект IDDCX_SWAPCHAIN , выделение которого необходимо проверить.

[out] pInSystemMemory

Результат проверка. Задайте значение TRUE, если буферы находятся в системной памяти; в противном случае задайте значение FALSE.

Возвращаемое значение

IddCxSwapChainInSystemMemory возвращает S_OK об успешном выполнении; в противном случае возвращается соответствующий код ошибки. Возможные ошибки: SwapChainObject — недопустимый объект цепочки буферов, а pInSystemMemory — пустой указатель.

Комментарии

Драйвер может вызвать IddCxSwapChainInSystemMemory в любой момент после вызова IddCxSwapChainSetDevice, чтобы проверка, если буферы для цепочки буферов находятся в системной памяти. Рекомендуется, чтобы драйверы вызывали этот метод при назначении новой цепочки буферов, но они могут вызывать ее в любой момент жизненного цикла объекта цепочки буферов.

Когда iddCxSwapChainInSystemMemory возвращает значение TRUE в pInSystemMemory, драйвер может использовать iddCxSwapChainReleaseAndAcquireBuffer или IddCxSwapChainReleaseAndAcquireSystemBuffer для освобождения и получения буферов из цепочки буферов. Драйвер должен продолжать использовать этот конкретный метод на протяжении всего времени существования этой конкретной цепочки буферов.

Когда iddCxSwapChainInSystemMemory возвращает значение FALSE, драйвер должен использовать IddCxSwapChainReleaseAndAcquireBuffer для освобождения и получения буферов из цепочки буферов.

Требования

Требование Значение
Минимальная версия сервера Windows Server 2022
Верхняя часть iddcx.h

См. также раздел

IddCxSwapChainReleaseAndAcquireBuffer

IddCxSwapChainReleaseAndAcquireSystemBuffer