2 * This file is part of FFmpeg.
4 * FFmpeg is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
9 * FFmpeg is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with FFmpeg; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
30 #include <dxgidebug.h>
35 #include "hwcontext.h"
36 #include "hwcontext_d3d11va.h"
37 #include "hwcontext_internal.h"
43 typedef HRESULT(WINAPI *PFN_CREATE_DXGI_FACTORY)(REFIID riid, void **ppFactory);
45 static AVOnce functions_loaded = AV_ONCE_INIT;
47 static PFN_CREATE_DXGI_FACTORY mCreateDXGIFactory;
48 static PFN_D3D11_CREATE_DEVICE mD3D11CreateDevice;
50 static av_cold void load_functions(void)
53 // We let these "leak" - this is fine, as unloading has no great benefit, and
54 // Windows will mark a DLL as loaded forever if its internal refcount overflows
55 // from too many LoadLibrary calls.
56 HANDLE d3dlib, dxgilib;
58 d3dlib = LoadLibrary("d3d11.dll");
59 dxgilib = LoadLibrary("dxgi.dll");
60 if (!d3dlib || !dxgilib)
63 mD3D11CreateDevice = (PFN_D3D11_CREATE_DEVICE) GetProcAddress(d3dlib, "D3D11CreateDevice");
64 mCreateDXGIFactory = (PFN_CREATE_DXGI_FACTORY) GetProcAddress(dxgilib, "CreateDXGIFactory");
66 // In UWP (which lacks LoadLibrary), CreateDXGIFactory isn't available,
67 // only CreateDXGIFactory1
68 mD3D11CreateDevice = (PFN_D3D11_CREATE_DEVICE) D3D11CreateDevice;
69 mCreateDXGIFactory = (PFN_CREATE_DXGI_FACTORY) CreateDXGIFactory1;
73 typedef struct D3D11VAFramesContext {
78 ID3D11Texture2D *staging_texture;
79 } D3D11VAFramesContext;
82 DXGI_FORMAT d3d_format;
83 enum AVPixelFormat pix_fmt;
84 } supported_formats[] = {
85 { DXGI_FORMAT_NV12, AV_PIX_FMT_NV12 },
86 { DXGI_FORMAT_P010, AV_PIX_FMT_P010 },
87 // Special opaque formats. The pix_fmt is merely a place holder, as the
88 // opaque format cannot be accessed directly.
89 { DXGI_FORMAT_420_OPAQUE, AV_PIX_FMT_YUV420P },
92 static void d3d11va_default_lock(void *ctx)
94 WaitForSingleObjectEx(ctx, INFINITE, FALSE);
97 static void d3d11va_default_unlock(void *ctx)
102 static void d3d11va_frames_uninit(AVHWFramesContext *ctx)
104 AVD3D11VAFramesContext *frames_hwctx = ctx->hwctx;
105 D3D11VAFramesContext *s = ctx->internal->priv;
107 if (frames_hwctx->texture)
108 ID3D11Texture2D_Release(frames_hwctx->texture);
109 frames_hwctx->texture = NULL;
111 if (s->staging_texture)
112 ID3D11Texture2D_Release(s->staging_texture);
113 s->staging_texture = NULL;
116 static int d3d11va_frames_get_constraints(AVHWDeviceContext *ctx,
117 const void *hwconfig,
118 AVHWFramesConstraints *constraints)
120 AVD3D11VADeviceContext *device_hwctx = ctx->hwctx;
121 int nb_sw_formats = 0;
125 constraints->valid_sw_formats = av_malloc_array(FF_ARRAY_ELEMS(supported_formats) + 1,
126 sizeof(*constraints->valid_sw_formats));
127 if (!constraints->valid_sw_formats)
128 return AVERROR(ENOMEM);
130 for (i = 0; i < FF_ARRAY_ELEMS(supported_formats); i++) {
131 UINT format_support = 0;
132 hr = ID3D11Device_CheckFormatSupport(device_hwctx->device, supported_formats[i].d3d_format, &format_support);
133 if (SUCCEEDED(hr) && (format_support & D3D11_FORMAT_SUPPORT_TEXTURE2D))
134 constraints->valid_sw_formats[nb_sw_formats++] = supported_formats[i].pix_fmt;
136 constraints->valid_sw_formats[nb_sw_formats] = AV_PIX_FMT_NONE;
138 constraints->valid_hw_formats = av_malloc_array(2, sizeof(*constraints->valid_hw_formats));
139 if (!constraints->valid_hw_formats)
140 return AVERROR(ENOMEM);
142 constraints->valid_hw_formats[0] = AV_PIX_FMT_D3D11;
143 constraints->valid_hw_formats[1] = AV_PIX_FMT_NONE;
148 static void free_texture(void *opaque, uint8_t *data)
150 ID3D11Texture2D_Release((ID3D11Texture2D *)opaque);
154 static AVBufferRef *wrap_texture_buf(ID3D11Texture2D *tex, int index)
157 AVD3D11FrameDescriptor *desc = av_mallocz(sizeof(*desc));
159 ID3D11Texture2D_Release(tex);
166 buf = av_buffer_create((uint8_t *)desc, sizeof(desc), free_texture, tex, 0);
168 ID3D11Texture2D_Release(tex);
176 static AVBufferRef *d3d11va_alloc_single(AVHWFramesContext *ctx)
178 D3D11VAFramesContext *s = ctx->internal->priv;
179 AVD3D11VAFramesContext *hwctx = ctx->hwctx;
180 AVD3D11VADeviceContext *device_hwctx = ctx->device_ctx->hwctx;
182 ID3D11Texture2D *tex;
183 D3D11_TEXTURE2D_DESC texDesc = {
185 .Height = ctx->height,
188 .SampleDesc = { .Count = 1 },
190 .Usage = D3D11_USAGE_DEFAULT,
191 .BindFlags = hwctx->BindFlags,
192 .MiscFlags = hwctx->MiscFlags,
195 hr = ID3D11Device_CreateTexture2D(device_hwctx->device, &texDesc, NULL, &tex);
197 av_log(ctx, AV_LOG_ERROR, "Could not create the texture (%lx)\n", (long)hr);
201 return wrap_texture_buf(tex, 0);
204 static AVBufferRef *d3d11va_pool_alloc(void *opaque, int size)
206 AVHWFramesContext *ctx = (AVHWFramesContext*)opaque;
207 D3D11VAFramesContext *s = ctx->internal->priv;
208 AVD3D11VAFramesContext *hwctx = ctx->hwctx;
209 D3D11_TEXTURE2D_DESC texDesc;
212 return d3d11va_alloc_single(ctx);
214 ID3D11Texture2D_GetDesc(hwctx->texture, &texDesc);
216 if (s->nb_surfaces_used >= texDesc.ArraySize) {
217 av_log(ctx, AV_LOG_ERROR, "Static surface pool size exceeded.\n");
221 ID3D11Texture2D_AddRef(hwctx->texture);
222 return wrap_texture_buf(hwctx->texture, s->nb_surfaces_used++);
225 static int d3d11va_frames_init(AVHWFramesContext *ctx)
227 AVD3D11VAFramesContext *hwctx = ctx->hwctx;
228 AVD3D11VADeviceContext *device_hwctx = ctx->device_ctx->hwctx;
229 D3D11VAFramesContext *s = ctx->internal->priv;
233 D3D11_TEXTURE2D_DESC texDesc;
235 for (i = 0; i < FF_ARRAY_ELEMS(supported_formats); i++) {
236 if (ctx->sw_format == supported_formats[i].pix_fmt) {
237 s->format = supported_formats[i].d3d_format;
241 if (i == FF_ARRAY_ELEMS(supported_formats)) {
242 av_log(ctx, AV_LOG_ERROR, "Unsupported pixel format: %s\n",
243 av_get_pix_fmt_name(ctx->sw_format));
244 return AVERROR(EINVAL);
247 texDesc = (D3D11_TEXTURE2D_DESC){
249 .Height = ctx->height,
252 .SampleDesc = { .Count = 1 },
253 .ArraySize = ctx->initial_pool_size,
254 .Usage = D3D11_USAGE_DEFAULT,
255 .BindFlags = hwctx->BindFlags,
256 .MiscFlags = hwctx->MiscFlags,
259 if (hwctx->texture) {
260 D3D11_TEXTURE2D_DESC texDesc2;
261 ID3D11Texture2D_GetDesc(hwctx->texture, &texDesc2);
263 if (texDesc.Width != texDesc2.Width ||
264 texDesc.Height != texDesc2.Height ||
265 texDesc.Format != texDesc2.Format) {
266 av_log(ctx, AV_LOG_ERROR, "User-provided texture has mismatching parameters\n");
267 return AVERROR(EINVAL);
269 } else if (texDesc.ArraySize > 0) {
270 hr = ID3D11Device_CreateTexture2D(device_hwctx->device, &texDesc, NULL, &hwctx->texture);
272 av_log(ctx, AV_LOG_ERROR, "Could not create the texture (%lx)\n", (long)hr);
273 return AVERROR_UNKNOWN;
277 ctx->internal->pool_internal = av_buffer_pool_init2(sizeof(AVD3D11FrameDescriptor),
278 ctx, d3d11va_pool_alloc, NULL);
279 if (!ctx->internal->pool_internal)
280 return AVERROR(ENOMEM);
285 static int d3d11va_get_buffer(AVHWFramesContext *ctx, AVFrame *frame)
287 AVD3D11FrameDescriptor *desc;
289 frame->buf[0] = av_buffer_pool_get(ctx->pool);
291 return AVERROR(ENOMEM);
293 desc = (AVD3D11FrameDescriptor *)frame->buf[0]->data;
295 frame->data[0] = (uint8_t *)desc->texture;
296 frame->data[1] = (uint8_t *)desc->index;
297 frame->format = AV_PIX_FMT_D3D11;
298 frame->width = ctx->width;
299 frame->height = ctx->height;
304 static int d3d11va_transfer_get_formats(AVHWFramesContext *ctx,
305 enum AVHWFrameTransferDirection dir,
306 enum AVPixelFormat **formats)
308 D3D11VAFramesContext *s = ctx->internal->priv;
309 enum AVPixelFormat *fmts;
311 fmts = av_malloc_array(2, sizeof(*fmts));
313 return AVERROR(ENOMEM);
315 fmts[0] = ctx->sw_format;
316 fmts[1] = AV_PIX_FMT_NONE;
318 // Don't signal support for opaque formats. Actual access would fail.
319 if (s->format == DXGI_FORMAT_420_OPAQUE)
320 fmts[0] = AV_PIX_FMT_NONE;
327 static int d3d11va_create_staging_texture(AVHWFramesContext *ctx)
329 AVD3D11VADeviceContext *device_hwctx = ctx->device_ctx->hwctx;
330 D3D11VAFramesContext *s = ctx->internal->priv;
332 D3D11_TEXTURE2D_DESC texDesc = {
334 .Height = ctx->height,
337 .SampleDesc = { .Count = 1 },
339 .Usage = D3D11_USAGE_STAGING,
340 .CPUAccessFlags = D3D11_CPU_ACCESS_READ | D3D11_CPU_ACCESS_WRITE,
343 hr = ID3D11Device_CreateTexture2D(device_hwctx->device, &texDesc, NULL, &s->staging_texture);
345 av_log(ctx, AV_LOG_ERROR, "Could not create the staging texture (%lx)\n", (long)hr);
346 return AVERROR_UNKNOWN;
352 static void fill_texture_ptrs(uint8_t *data[4], int linesize[4],
353 AVHWFramesContext *ctx,
354 D3D11_TEXTURE2D_DESC *desc,
355 D3D11_MAPPED_SUBRESOURCE *map)
359 for (i = 0; i < 4; i++)
360 linesize[i] = map->RowPitch;
362 av_image_fill_pointers(data, ctx->sw_format, desc->Height,
363 (uint8_t*)map->pData, linesize);
366 static int d3d11va_transfer_data(AVHWFramesContext *ctx, AVFrame *dst,
369 AVD3D11VADeviceContext *device_hwctx = ctx->device_ctx->hwctx;
370 D3D11VAFramesContext *s = ctx->internal->priv;
371 int download = src->format == AV_PIX_FMT_D3D11;
372 const AVFrame *frame = download ? src : dst;
373 const AVFrame *other = download ? dst : src;
374 // (The interface types are compatible.)
375 ID3D11Resource *texture = (ID3D11Resource *)(ID3D11Texture2D *)frame->data[0];
376 int index = (intptr_t)frame->data[1];
377 ID3D11Resource *staging;
378 int w = FFMIN(dst->width, src->width);
379 int h = FFMIN(dst->height, src->height);
380 uint8_t *map_data[4];
382 D3D11_TEXTURE2D_DESC desc;
383 D3D11_MAPPED_SUBRESOURCE map;
386 if (frame->hw_frames_ctx->data != (uint8_t *)ctx || other->format != ctx->sw_format)
387 return AVERROR(EINVAL);
389 device_hwctx->lock(device_hwctx->lock_ctx);
391 if (!s->staging_texture) {
392 int res = d3d11va_create_staging_texture(ctx);
397 staging = (ID3D11Resource *)s->staging_texture;
399 ID3D11Texture2D_GetDesc(s->staging_texture, &desc);
402 ID3D11DeviceContext_CopySubresourceRegion(device_hwctx->device_context,
404 texture, index, NULL);
406 hr = ID3D11DeviceContext_Map(device_hwctx->device_context,
407 staging, 0, D3D11_MAP_READ, 0, &map);
411 fill_texture_ptrs(map_data, map_linesize, ctx, &desc, &map);
413 av_image_copy(dst->data, dst->linesize, map_data, map_linesize,
414 ctx->sw_format, w, h);
416 ID3D11DeviceContext_Unmap(device_hwctx->device_context, staging, 0);
418 hr = ID3D11DeviceContext_Map(device_hwctx->device_context,
419 staging, 0, D3D11_MAP_WRITE, 0, &map);
423 fill_texture_ptrs(map_data, map_linesize, ctx, &desc, &map);
425 av_image_copy(map_data, map_linesize, src->data, src->linesize,
426 ctx->sw_format, w, h);
428 ID3D11DeviceContext_Unmap(device_hwctx->device_context, staging, 0);
430 ID3D11DeviceContext_CopySubresourceRegion(device_hwctx->device_context,
431 texture, index, 0, 0, 0,
435 device_hwctx->unlock(device_hwctx->lock_ctx);
439 av_log(ctx, AV_LOG_ERROR, "Unable to lock D3D11VA surface (%lx)\n", (long)hr);
440 device_hwctx->unlock(device_hwctx->lock_ctx);
441 return AVERROR_UNKNOWN;
444 static int d3d11va_device_init(AVHWDeviceContext *hwdev)
446 AVD3D11VADeviceContext *device_hwctx = hwdev->hwctx;
449 if (!device_hwctx->lock) {
450 device_hwctx->lock_ctx = CreateMutex(NULL, 0, NULL);
451 if (device_hwctx->lock_ctx == INVALID_HANDLE_VALUE) {
452 av_log(NULL, AV_LOG_ERROR, "Failed to create a mutex\n");
453 return AVERROR(EINVAL);
455 device_hwctx->lock = d3d11va_default_lock;
456 device_hwctx->unlock = d3d11va_default_unlock;
459 if (!device_hwctx->device_context) {
460 ID3D11Device_GetImmediateContext(device_hwctx->device, &device_hwctx->device_context);
461 if (!device_hwctx->device_context)
462 return AVERROR_UNKNOWN;
465 if (!device_hwctx->video_device) {
466 hr = ID3D11DeviceContext_QueryInterface(device_hwctx->device, &IID_ID3D11VideoDevice,
467 (void **)&device_hwctx->video_device);
469 return AVERROR_UNKNOWN;
472 if (!device_hwctx->video_context) {
473 hr = ID3D11DeviceContext_QueryInterface(device_hwctx->device_context, &IID_ID3D11VideoContext,
474 (void **)&device_hwctx->video_context);
476 return AVERROR_UNKNOWN;
482 static void d3d11va_device_uninit(AVHWDeviceContext *hwdev)
484 AVD3D11VADeviceContext *device_hwctx = hwdev->hwctx;
486 if (device_hwctx->device) {
487 ID3D11Device_Release(device_hwctx->device);
488 device_hwctx->device = NULL;
491 if (device_hwctx->device_context) {
492 ID3D11DeviceContext_Release(device_hwctx->device_context);
493 device_hwctx->device_context = NULL;
496 if (device_hwctx->video_device) {
497 ID3D11VideoDevice_Release(device_hwctx->video_device);
498 device_hwctx->video_device = NULL;
501 if (device_hwctx->video_context) {
502 ID3D11VideoContext_Release(device_hwctx->video_context);
503 device_hwctx->video_context = NULL;
506 if (device_hwctx->lock == d3d11va_default_lock) {
507 CloseHandle(device_hwctx->lock_ctx);
508 device_hwctx->lock_ctx = INVALID_HANDLE_VALUE;
509 device_hwctx->lock = NULL;
513 static int d3d11va_device_create(AVHWDeviceContext *ctx, const char *device,
514 AVDictionary *opts, int flags)
516 AVD3D11VADeviceContext *device_hwctx = ctx->hwctx;
519 IDXGIAdapter *pAdapter = NULL;
520 ID3D10Multithread *pMultithread;
521 UINT creationFlags = D3D11_CREATE_DEVICE_VIDEO_SUPPORT;
522 int is_debug = !!av_dict_get(opts, "debug", NULL, 0);
525 // (On UWP we can't check this.)
527 if (!LoadLibrary("d3d11_1sdklayers.dll"))
532 creationFlags |= D3D11_CREATE_DEVICE_DEBUG;
534 if ((ret = ff_thread_once(&functions_loaded, load_functions)) != 0)
535 return AVERROR_UNKNOWN;
536 if (!mD3D11CreateDevice || !mCreateDXGIFactory) {
537 av_log(ctx, AV_LOG_ERROR, "Failed to load D3D11 library or its functions\n");
538 return AVERROR_UNKNOWN;
542 IDXGIFactory2 *pDXGIFactory;
543 hr = mCreateDXGIFactory(&IID_IDXGIFactory2, (void **)&pDXGIFactory);
545 int adapter = atoi(device);
546 if (FAILED(IDXGIFactory2_EnumAdapters(pDXGIFactory, adapter, &pAdapter)))
548 IDXGIFactory2_Release(pDXGIFactory);
553 DXGI_ADAPTER_DESC desc;
554 hr = IDXGIAdapter2_GetDesc(pAdapter, &desc);
556 av_log(ctx, AV_LOG_INFO, "Using device %04x:%04x (%ls).\n",
557 desc.VendorId, desc.DeviceId, desc.Description);
561 hr = mD3D11CreateDevice(pAdapter, pAdapter ? D3D_DRIVER_TYPE_UNKNOWN : D3D_DRIVER_TYPE_HARDWARE, NULL, creationFlags, NULL, 0,
562 D3D11_SDK_VERSION, &device_hwctx->device, NULL, NULL);
564 IDXGIAdapter_Release(pAdapter);
566 av_log(ctx, AV_LOG_ERROR, "Failed to create Direct3D device (%lx)\n", (long)hr);
567 return AVERROR_UNKNOWN;
570 hr = ID3D11Device_QueryInterface(device_hwctx->device, &IID_ID3D10Multithread, (void **)&pMultithread);
572 ID3D10Multithread_SetMultithreadProtected(pMultithread, TRUE);
573 ID3D10Multithread_Release(pMultithread);
576 #if !HAVE_UWP && HAVE_DXGIDEBUG_H
578 HANDLE dxgidebug_dll = LoadLibrary("dxgidebug.dll");
580 HRESULT (WINAPI * pf_DXGIGetDebugInterface)(const GUID *riid, void **ppDebug)
581 = (void *)GetProcAddress(dxgidebug_dll, "DXGIGetDebugInterface");
582 if (pf_DXGIGetDebugInterface) {
583 IDXGIDebug *dxgi_debug = NULL;
584 hr = pf_DXGIGetDebugInterface(&IID_IDXGIDebug, (void**)&dxgi_debug);
585 if (SUCCEEDED(hr) && dxgi_debug)
586 IDXGIDebug_ReportLiveObjects(dxgi_debug, DXGI_DEBUG_ALL, DXGI_DEBUG_RLO_ALL);
595 const HWContextType ff_hwcontext_type_d3d11va = {
596 .type = AV_HWDEVICE_TYPE_D3D11VA,
599 .device_hwctx_size = sizeof(AVD3D11VADeviceContext),
600 .frames_hwctx_size = sizeof(AVD3D11VAFramesContext),
601 .frames_priv_size = sizeof(D3D11VAFramesContext),
603 .device_create = d3d11va_device_create,
604 .device_init = d3d11va_device_init,
605 .device_uninit = d3d11va_device_uninit,
606 .frames_get_constraints = d3d11va_frames_get_constraints,
607 .frames_init = d3d11va_frames_init,
608 .frames_uninit = d3d11va_frames_uninit,
609 .frames_get_buffer = d3d11va_get_buffer,
610 .transfer_get_formats = d3d11va_transfer_get_formats,
611 .transfer_data_to = d3d11va_transfer_data,
612 .transfer_data_from = d3d11va_transfer_data,
614 .pix_fmts = (const enum AVPixelFormat[]){ AV_PIX_FMT_D3D11, AV_PIX_FMT_NONE },