From 05b829f36d1af67b51b1878a6873f8ef46f150ba Mon Sep 17 00:00:00 2001 From: Amer Koleci Date: Wed, 7 Sep 2022 11:35:15 +0200 Subject: [PATCH] Improvements in Direct3D11 bindings and add helper structs + methods. --- src/Generator/Program.cs | 3 + src/Vortice.Win32/ComPtr.cs | 14 + src/Vortice.Win32/Generated/Direct3D11.xml | 12638 +++++++++++----- .../Generated/Graphics/Direct3D11.cs | 4 +- .../Graphics/Direct3D11.Manual.cs | 4 +- .../Direct3D11/DepthStencilViewDescription.cs | 168 + .../Direct3D11/ID3D11DeviceExtensions.cs | 95 + .../Direct3D11/RenderTargetViewDescription.cs | 217 + .../Direct3D11/Texture1DDescription.cs | 50 + .../Direct3D11/Texture2DDescription.cs | 61 + .../Direct3D11/Texture3DDescription.cs | 56 + .../Graphics/Dxgi.Common.Manual.cs | 2 +- src/samples/01-ClearScreen/Program.cs | 31 +- .../01-ClearScreen/VertexPositionColor.cs | 31 + 14 files changed, 9580 insertions(+), 3794 deletions(-) create mode 100644 src/Vortice.Win32/Graphics/Direct3D11/DepthStencilViewDescription.cs create mode 100644 src/Vortice.Win32/Graphics/Direct3D11/ID3D11DeviceExtensions.cs create mode 100644 src/Vortice.Win32/Graphics/Direct3D11/RenderTargetViewDescription.cs create mode 100644 src/Vortice.Win32/Graphics/Direct3D11/Texture1DDescription.cs create mode 100644 src/Vortice.Win32/Graphics/Direct3D11/Texture2DDescription.cs create mode 100644 src/Vortice.Win32/Graphics/Direct3D11/Texture3DDescription.cs create mode 100644 src/samples/01-ClearScreen/VertexPositionColor.cs diff --git a/src/Generator/Program.cs b/src/Generator/Program.cs index 1c83b07..d299c8f 100644 --- a/src/Generator/Program.cs +++ b/src/Generator/Program.cs @@ -228,6 +228,7 @@ public static class Program { "D3D11_MAP_FLAG", "MapFlags" }, { "D3D11_FORMAT_SUPPORT", "FormatSupport" }, { "D3D11_FORMAT_SUPPORT2", "FormatSupport2" }, + { "D3D11_DSV_FLAG", "DsvFlags" }, }; private static readonly Dictionary s_structFieldTypeRemap = new() @@ -258,6 +259,8 @@ public static class Program { "D3D11_FEATURE_DATA_FORMAT_SUPPORT::OutFormatSupport", "D3D11_FORMAT_SUPPORT" }, { "D3D11_FEATURE_DATA_FORMAT_SUPPORT2::OutFormatSupport2", "D3D11_FORMAT_SUPPORT2" }, + + { "D3D11_DEPTH_STENCIL_VIEW_DESC::Flags", "D3D11_DSV_FLAG" }, }; private static readonly HashSet s_visitedEnums = new(); diff --git a/src/Vortice.Win32/ComPtr.cs b/src/Vortice.Win32/ComPtr.cs index 71c7a94..e7ad658 100644 --- a/src/Vortice.Win32/ComPtr.cs +++ b/src/Vortice.Win32/ComPtr.cs @@ -262,6 +262,20 @@ public unsafe struct ComPtr : IDisposable return GetAddressOf(); } + /// + /// Moves the current instance and resets it without releasing the reference. + /// + /// The moved instance. + [MethodImpl(MethodImplOptions.AggressiveInlining)] + public ComPtr Move() + { + ComPtr copy = default; + + Unsafe.AsRef(in this).Swap(ref copy); + + return copy; + } + /// Resets the current instance by decrementing the reference count for the target COM object and setting the internal raw pointer to . /// The updated reference count for the COM object that was in use, if any. [MethodImpl(MethodImplOptions.AggressiveInlining)] diff --git a/src/Vortice.Win32/Generated/Direct3D11.xml b/src/Vortice.Win32/Generated/Direct3D11.xml index 0756f1b..63e051e 100644 --- a/src/Vortice.Win32/Generated/Direct3D11.xml +++ b/src/Vortice.Win32/Generated/Direct3D11.xml @@ -3,20 +3,28 @@ Gets the content description that was used to create the video processor. - Microsoft Docs: - A pointer to a D3D11_VIDEO_PROCESSOR_CONTENT_DESC structure that receives the content description. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_PROCESSOR_CONTENT_DESC structure that receives the content description. + This interface encapsulates an HLSL dynamic linkage. - Microsoft Docs: + + Microsoft Docs: + Describes the shape of a tile by specifying its dimensions. - Microsoft Docs: + + Microsoft Docs: + @@ -31,40 +39,62 @@ Describes a 3D texture. - Microsoft Docs: + + Microsoft Docs: + - Texture width (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Texture width (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - Texture height (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Texture height (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - Texture depth (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Texture depth (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - The maximum number of mipmap levels in the texture. See the remarks in D3D11_TEX1D_SRV. Use 1 for a multisampled texture; or 0 to generate a full set of subtextures. + + The maximum number of mipmap levels in the texture. See the remarks in D3D11_TEX1D_SRV. Use 1 for a multisampled texture; or 0 to generate a full set of subtextures. + - Texture format (see DXGI_FORMAT). + + Texture format (see DXGI_FORMAT). + - Value that identifies how the texture is to be read from and written to. The most common value is D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + + Value that identifies how the texture is to be read from and written to. The most common value is D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + - Flags (see D3D11_BIND_FLAG) for binding to pipeline stages. The flags can be combined by a logical OR. + + Flags (see D3D11_BIND_FLAG) for binding to pipeline stages. The flags can be combined by a logical OR. + - Flags (see D3D11_CPU_ACCESS_FLAG) to specify the types of CPU access allowed. Use 0 if CPU access is not required. These flags can be combined with a logical OR. + + Flags (see D3D11_CPU_ACCESS_FLAG) to specify the types of CPU access allowed. Use 0 if CPU access is not required. These flags can be combined with a logical OR. + - Flags (see D3D11_RESOURCE_MISC_FLAG) that identify other, less common resource options. Use 0 if none of these flags apply. These flags can be combined with a logical OR. + + Flags (see D3D11_RESOURCE_MISC_FLAG) that identify other, less common resource options. Use 0 if none of these flags apply. These flags can be combined with a logical OR. + Identify the portion of a depth-stencil buffer for writing depth data. - Microsoft Docs: + + Microsoft Docs: + @@ -76,49 +106,80 @@ Pop a storage filter from the top of the storage-filter stack. - Microsoft Docs: + + Microsoft Docs: + Create a shader-resource view for accessing data in a resource. - Microsoft Docs: - Pointer to the resource that will serve as input to a shader. This resource must have been created with the D3D11_BIND_SHADER_RESOURCE - flag. - Pointer to a shader-resource view description (see D3D11_SHADER_RESOURCE_VIEW_DESC). Set this parameter to NULL to create a - view that accesses the entire resource (using the format the resource was created with). - Address of a pointer to an ID3D11ShaderResourceView. Set this parameter to NULL to validate the - other input parameters (the method will return S_FALSE if the other input parameters pass validation). + + Microsoft Docs: + + + Pointer to the resource that will serve as input to a shader. This resource must have been created with the + D3D11_BIND_SHADER_RESOURCE + flag. + + + Pointer to a shader-resource view description (see D3D11_SHADER_RESOURCE_VIEW_DESC). Set this parameter to NULL to create a + view that accesses the entire resource (using the format the resource was created with). + + + Address of a pointer to an ID3D11ShaderResourceView. Set this parameter to NULL to validate the + other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Gets a decoder configuration that is supported by the driver. - Microsoft Docs: - A pointer to a D3D11_VIDEO_DECODER_DESC structure that describes the video stream. - The zero-based index of the decoder configuration. To get the number of configurations that the driver supports, call ID3D11VideoDevice::GetVideoDecoderConfigCount. - A pointer to a D3D11_VIDEO_DECODER_CONFIG structure. The method fills in the structure with the decoder configuration. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_DECODER_DESC structure that describes the video stream. + + + The zero-based index of the decoder configuration. To get the number of configurations that the driver supports, call ID3D11VideoDevice::GetVideoDecoderConfigCount. + + + A pointer to a D3D11_VIDEO_DECODER_CONFIG structure. The method fills in the structure with the decoder configuration. + Enables or disables an image filter for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - The filter, specified as a D3D11_VIDEO_PROCESSOR_FILTER value. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + The filter, specified as a D3D11_VIDEO_PROCESSOR_FILTER value. -To query which filters the driver supports, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps. + To query which filters the driver supports, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps. + Specifies whether to enable the filter. - The filter level. If Enable is FALSE, this parameter is ignored. + + The filter level. If Enable is FALSE, this parameter is ignored. -To find the valid range of levels for a specified filter, call ID3D11VideoProcessorEnumerator::GetVideoProcessorFilterRange. + To find the valid range of levels for a specified filter, call ID3D11VideoProcessorEnumerator::GetVideoProcessorFilterRange. + Describes a compressed buffer for decoding. - Microsoft Docs: + + Microsoft Docs: + @@ -134,67 +195,107 @@ To find the valid range of levels for a specified filter, call - The size of the buffer specified in the pIV parameter. If pIV is NULL, set this member to zero. + + The size of the buffer specified in the pIV parameter. If pIV is NULL, set this member to zero. + - A pointer to an array of D3D11_VIDEO_DECODER_SUB_SAMPLE_MAPPING_BLOCK structures, which indicates exactly which bytes in the decode buffer are encrypted and which are in the clear. If the decode buffer does not contain encrypted data, set this member to NULL. + + A pointer to an array of D3D11_VIDEO_DECODER_SUB_SAMPLE_MAPPING_BLOCK structures, which indicates exactly which bytes in the decode buffer are encrypted and which are in the clear. If the decode buffer does not contain encrypted data, set this member to NULL. -Values in the sub sample mapping blocks are relative to the start of the decode buffer. + Values in the sub sample mapping blocks are relative to the start of the decode buffer. + - The number of D3D11_VIDEO_DECODER_SUB_SAMPLE_MAPPING_BLOCK structures specified in the pSubSampleMappingBlocks parameter. If pSubSampleMappingBlocks is NULL, set this member to zero. + + The number of D3D11_VIDEO_DECODER_SUB_SAMPLE_MAPPING_BLOCK structures specified in the pSubSampleMappingBlocks parameter. If pSubSampleMappingBlocks is NULL, set this member to zero. + Creates a shader-resource view for accessing data in a resource. - Microsoft Docs: - Pointer to the resource that will serve as input to a shader. This resource must have been created with the D3D11_BIND_SHADER_RESOURCE flag. - A pointer to a D3D11_SHADER_RESOURCE_VIEW_DESC1 structure that describes a shader-resource view. Set this parameter to NULL to create a - view that accesses the entire resource (using the format the resource was created with). - A pointer to a memory block that receives a pointer to a ID3D11ShaderResourceView1 interface for the created shader-resource view. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + + Microsoft Docs: + + + Pointer to the resource that will serve as input to a shader. This resource must have been created with the D3D11_BIND_SHADER_RESOURCE flag. + + + A pointer to a D3D11_SHADER_RESOURCE_VIEW_DESC1 structure that describes a shader-resource view. Set this parameter to NULL to create a + view that accesses the entire resource (using the format the resource was created with). + + + A pointer to a memory block that receives a pointer to a ID3D11ShaderResourceView1 interface for the created shader-resource view. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Gets an immediate context, which can play back command lists. - Microsoft Docs: - Upon completion of the method, the passed pointer to an ID3D11DeviceContext3 interface pointer is initialized. + + Microsoft Docs: + + + Upon completion of the method, the passed pointer to an ID3D11DeviceContext3 interface pointer is initialized. + Sets the color space for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - A pointer to a D3D11_VIDEO_PROCESSOR_COLOR_SPACE structure that specifies the color space. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + A pointer to a D3D11_VIDEO_PROCESSOR_COLOR_SPACE structure that specifies the color space. + Sets the target rectangle for the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + Specifies whether to apply the target rectangle. - A pointer to a RECT structure that specifies the target rectangle. If Enable is FALSE, this parameter is ignored. + + A pointer to a RECT structure that specifies the target rectangle. If Enable is FALSE, this parameter is ignored. + Contains input data for a D3D11_AUTHENTICATED_CONFIGURE_PROTECTION command. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_CONFIGURE_INPUT structure that contains the command GUID and other data. + + A D3D11_AUTHENTICATED_CONFIGURE_INPUT structure that contains the command GUID and other data. + - A D3D11_AUTHENTICATED_PROTECTION_FLAGS union that specifies the protection level. + + A D3D11_AUTHENTICATED_PROTECTION_FLAGS union that specifies the protection level. + Specifies the elements in a buffer resource to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + @@ -207,13 +308,17 @@ Values in the sub sample mapping blocks are relative to the start of the decode The total number of elements in the view. - The width of each element (in bytes). - This can be determined from the format stored in the shader-resource-view description. + + The width of each element (in bytes). + This can be determined from the format stored in the shader-resource-view description. + Identifies the texture resource for a video processor input view. - Microsoft Docs: + + Microsoft Docs: + @@ -225,44 +330,68 @@ Values in the sub sample mapping blocks are relative to the start of the decode Binds resources to the output-merger stage. - Microsoft Docs: - Number of render targets to bind (ranges between 0 and D3D11_SIMULTANEOUS_RENDER_TARGET_COUNT). If this parameter is nonzero, the number of entries in the array to which ppRenderTargetViews points must equal the number in this parameter. If you set NumRTVs to D3D11_KEEP_RENDER_TARGETS_AND_DEPTH_STENCIL (0xffffffff), this method does not modify the currently bound render-target views (RTVs) and also does not modify depth-stencil view (DSV). - Pointer to an array of ID3D11RenderTargetViews that represent the render targets to bind to the device. - If this parameter is NULL and NumRTVs is 0, no render targets are bound. - Pointer to a ID3D11DepthStencilView that represents the depth-stencil view to bind to the device. - If this parameter is NULL, the depth-stencil view is not bound. - Index into a zero-based array to begin setting unordered-access views (ranges from 0 to D3D11_PS_CS_UAV_REGISTER_COUNT - 1). + + Microsoft Docs: + + + Number of render targets to bind (ranges between 0 and D3D11_SIMULTANEOUS_RENDER_TARGET_COUNT). If this parameter is nonzero, the number of entries in the array to which ppRenderTargetViews points must equal the number in this parameter. If you set NumRTVs to D3D11_KEEP_RENDER_TARGETS_AND_DEPTH_STENCIL (0xffffffff), this method does not modify the currently bound render-target views (RTVs) and also does not modify depth-stencil view (DSV). + + + Pointer to an array of ID3D11RenderTargetViews that represent the render targets to bind to the device. + If this parameter is NULL and NumRTVs is 0, no render targets are bound. + + + Pointer to a ID3D11DepthStencilView that represents the depth-stencil view to bind to the device. + If this parameter is NULL, the depth-stencil view is not bound. + + + Index into a zero-based array to begin setting unordered-access views (ranges from 0 to D3D11_PS_CS_UAV_REGISTER_COUNT - 1). -For the Direct3D 11.1 runtime, which is available starting with Windows 8, this value can range from 0 to D3D11_1_UAV_SLOT_COUNT - 1. D3D11_1_UAV_SLOT_COUNT is defined as 64. - + For the Direct3D 11.1 runtime, which is available starting with Windows 8, this value can range from 0 to D3D11_1_UAV_SLOT_COUNT - 1. D3D11_1_UAV_SLOT_COUNT is defined as 64. -For pixel shaders, UAVStartSlot should be equal to the number of render-target views being bound. - Number of unordered-access views (UAVs) in ppUnorderedAccessViews. If you set NumUAVs to D3D11_KEEP_UNORDERED_ACCESS_VIEWS (0xffffffff), this method does not modify the currently bound unordered-access views. - -For the Direct3D 11.1 runtime, which is available starting with Windows 8, this value can range from 0 to D3D11_1_UAV_SLOT_COUNT - UAVStartSlot. - Pointer to an array of ID3D11UnorderedAccessViews that represent the unordered-access views to bind to the device. - If this parameter is NULL and NumUAVs is 0, no unordered-access views are bound. - An array of append and consume buffer offsets. A value of -1 indicates to keep the current offset. Any other values set the hidden counter - for that appendable and consumable UAV. pUAVInitialCounts is relevant only for UAVs that were created with either - D3D11_BUFFER_UAV_FLAG_APPEND or D3D11_BUFFER_UAV_FLAG_COUNTER specified - when the UAV was created; otherwise, the argument is ignored. + For pixel shaders, UAVStartSlot should be equal to the number of render-target views being bound. + + + Number of unordered-access views (UAVs) in ppUnorderedAccessViews. If you set NumUAVs to D3D11_KEEP_UNORDERED_ACCESS_VIEWS (0xffffffff), this method does not modify the currently bound unordered-access views. + + + For the Direct3D 11.1 runtime, which is available starting with Windows 8, this value can range from 0 to D3D11_1_UAV_SLOT_COUNT - UAVStartSlot. + + + Pointer to an array of ID3D11UnorderedAccessViews that represent the unordered-access views to bind to the device. + If this parameter is NULL and NumUAVs is 0, no unordered-access views are bound. + + + An array of append and consume buffer offsets. A value of -1 indicates to keep the current offset. Any other values set the hidden counter + for that appendable and consumable UAV. pUAVInitialCounts is relevant only for UAVs that were created with either + D3D11_BUFFER_UAV_FLAG_APPEND or D3D11_BUFFER_UAV_FLAG_COUNTER specified + when the UAV was created; otherwise, the argument is ignored. + Invalidate the pointer to a resource and reenable the GPU's access to that resource. - Microsoft Docs: - A pointer to a ID3D11Resource interface. + + Microsoft Docs: + + + A pointer to a ID3D11Resource interface. + A subresource to be unmapped. Indicates whether the video decoder supports downsampling with the specified input format, and whether real-time downsampling is supported. - Microsoft Docs: + + Microsoft Docs: + An object describing the decoding profile, the resolution, and format of the input stream. This is the resolution and format to be downsampled. - A DXGI_COLOR_SPACE_TYPE value that specifies the colorspace of the reference frame data. + + A DXGI_COLOR_SPACE_TYPE value that specifies the colorspace of the reference frame data. + The configuration data associated with the decode profile. The frame rate of the video content. This is used by the driver to determine whether the video can be decoded in real-time. An object describing the resolution, format, and colorspace of the output frames. This is the destination resolution and format of the downsample operation. @@ -273,7 +402,9 @@ For the Direct3D 11.1 runtime, which is available starting with Windows 8, this Describes a video sample. - Microsoft Docs: + + Microsoft Docs: + @@ -291,7 +422,9 @@ For the Direct3D 11.1 runtime, which is available starting with Windows 8, this Draw indexed, instanced primitives. - Microsoft Docs: + + Microsoft Docs: + Number of indices read from the index buffer for each instance. Number of instances to draw. The location of the first index read by the GPU from the index buffer. @@ -302,26 +435,38 @@ For the Direct3D 11.1 runtime, which is available starting with Windows 8, this Contains the response to a D3D11_AUTHENTICATED_QUERY_CHANNEL_TYPE query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + - A D3D11_AUTHENTICATED_CHANNEL_TYPE value that specifies the channel type. + + A D3D11_AUTHENTICATED_CHANNEL_TYPE value that specifies the channel type. + Gets an immediate context, which can play back command lists. - Microsoft Docs: - Upon completion of the method, the passed pointer to an ID3D11DeviceContext2 interface pointer is initialized. + + Microsoft Docs: + + + Upon completion of the method, the passed pointer to an ID3D11DeviceContext2 interface pointer is initialized. + Specifies the type of I/O bus that is used by the graphics adapter. - Microsoft Docs: + + Microsoft Docs: + @@ -355,83 +500,131 @@ For the Direct3D 11.1 runtime, which is available starting with Windows 8, this The graphics adapter is connected to the motherboard through a daughterboard connector, and the graphics adapter is inside an enclosure that is not user accessible. - One of the D3D11_BUS_IMPL_MODIFIER_Xxx flags is set. + + One of the D3D11_BUS_IMPL_MODIFIER_Xxx flags is set. + Get application-defined data from a device. - Microsoft Docs: + + Microsoft Docs: + Guid associated with the data. - A pointer to a variable that on input contains the size, in bytes, of the buffer that pData points to, and on output contains the size, in bytes, of the amount of data that GetPrivateData retrieved. - A pointer to a buffer that GetPrivateData fills with data from the device if pDataSize points to a value that specifies a buffer large enough to hold the data. + + A pointer to a variable that on input contains the size, in bytes, of the buffer that pData points to, and on output contains the size, in bytes, of the amount of data that GetPrivateData retrieved. + + + A pointer to a buffer that GetPrivateData fills with data from the device if pDataSize points to a value that specifies a buffer large enough to hold the data. + Identifies the input surfaces that can be accessed during video processing. - Microsoft Docs: + + Microsoft Docs: + Enables or disables automatic processing features on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - If TRUE, automatic processing features are enabled. If FALSE, the driver disables any extra video processing that it might be performing. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + If TRUE, automatic processing features are enabled. If FALSE, the driver disables any extra video processing that it might be performing. + Add a debug message to the message queue and send that message to debug output. - Microsoft Docs: - Category of a message (see D3D11_MESSAGE_CATEGORY). - Severity of a message (see D3D11_MESSAGE_SEVERITY). - Unique identifier of a message (see D3D11_MESSAGE_ID). + + Microsoft Docs: + + + Category of a message (see D3D11_MESSAGE_CATEGORY). + + + Severity of a message (see D3D11_MESSAGE_SEVERITY). + + + Unique identifier of a message (see D3D11_MESSAGE_ID). + User-defined message. Set a rendering predicate. - Microsoft Docs: - A pointer to the ID3D11Predicate interface that represents the rendering predicate. A NULL value indicates "no" predication; in this case, the value of PredicateValue is irrelevant but will be preserved for ID3D11DeviceContext::GetPredication. - If TRUE, rendering will be affected by when the predicate's conditions are met. If FALSE, rendering will be affected when the conditions are not met. + + Microsoft Docs: + + + A pointer to the ID3D11Predicate interface that represents the rendering predicate. A NULL value indicates "no" predication; in this case, the value of PredicateValue is irrelevant but will be preserved for ID3D11DeviceContext::GetPredication. + + + If TRUE, rendering will be affected by when the predicate's conditions are met. If FALSE, rendering will be affected when the conditions are not met. + Get the domain-shader resources. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin getting shader resources from (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). The number of resources to get from the device. Up to a maximum of 128 slots are available for shader resources (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to be returned by the device. + + Array of shader resource view interfaces to be returned by the device. + Performs an extended function for decoding. - Microsoft Docs: - A pointer to the ID3D11VideoDecoder interface. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoder. - A pointer to a D3D11_VIDEO_DECODER_EXTENSION structure that contains data for the function. + + Microsoft Docs: + + + A pointer to the ID3D11VideoDecoder interface. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoder. + + + A pointer to a D3D11_VIDEO_DECODER_EXTENSION structure that contains data for the function. + Get the number of milliseconds to sleep after IDXGISwapChain::Present is called. - Microsoft Docs: + + Microsoft Docs: + Get the size of the storage-filter stack in bytes. - Microsoft Docs: + + Microsoft Docs: + Specifies the subresources from an array of 1D textures to use in a render-target view. - Microsoft Docs: + + Microsoft Docs: + @@ -446,32 +639,44 @@ For the Direct3D 11.1 runtime, which is available starting with Windows 8, this A module-instance interface is used for resource rebinding. - Microsoft Docs: + + Microsoft Docs: + Get the compute-shader resources. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin getting shader resources from (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). The number of resources to get from the device. Up to a maximum of 128 slots are available for shader resources (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to be returned by the device. + + Array of shader resource view interfaces to be returned by the device. + The ID3D11DeviceContext interface represents a device context which generates rendering commands. - Microsoft Docs: + + Microsoft Docs: + Contains the response to a D3D11_AUTHENTICATED_QUERY_CURRENT_ENCRYPTION_WHEN_ACCESSIBLE query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + A GUID that specifies the current encryption type. @@ -479,49 +684,73 @@ For the Direct3D 11.1 runtime, which is available starting with Windows 8, this Describes a buffer resource. - Microsoft Docs: + + Microsoft Docs: + Size of the buffer in bytes. - Identify how the buffer is expected to be read from and written to. Frequency of update is a key factor. The most common value is typically D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + + Identify how the buffer is expected to be read from and written to. Frequency of update is a key factor. The most common value is typically D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + - Identify how the buffer will be bound to the pipeline. Flags (see D3D11_BIND_FLAG) can be combined with a logical OR. + + Identify how the buffer will be bound to the pipeline. Flags (see D3D11_BIND_FLAG) can be combined with a logical OR. + - CPU access flags (see D3D11_CPU_ACCESS_FLAG) or 0 if no CPU access is necessary. Flags can be combined with a logical OR. + + CPU access flags (see D3D11_CPU_ACCESS_FLAG) or 0 if no CPU access is necessary. Flags can be combined with a logical OR. + - Miscellaneous flags (see D3D11_RESOURCE_MISC_FLAG) or 0 if unused. Flags can be combined with a logical OR. + + Miscellaneous flags (see D3D11_RESOURCE_MISC_FLAG) or 0 if unused. Flags can be combined with a logical OR. + - The size of each element in the buffer structure (in bytes) when the buffer represents a structured buffer. For more info about structured buffers, see Structured Buffer. + + The size of each element in the buffer structure (in bytes) when the buffer represents a structured buffer. For more info about structured buffers, see Structured Buffer. -The size value in StructureByteStride must match the size of the format that you use for views of the buffer. For example, if you use a shader resource view (SRV) to read a buffer in a pixel shader, the SRV format size must match the size value in StructureByteStride. + The size value in StructureByteStride must match the size of the format that you use for views of the buffer. For example, if you use a shader resource view (SRV) to read a buffer in a pixel shader, the SRV format size must match the size value in StructureByteStride. + Sets the source rectangle for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + Specifies whether to apply the source rectangle. - A pointer to a RECT structure that specifies the source rectangle. If Enable is FALSE, this parameter is ignored. + + A pointer to a RECT structure that specifies the source rectangle. If Enable is FALSE, this parameter is ignored. + Enumerates the video processor capabilities of a Microsoft Direct3D 11 device. - Microsoft Docs: + + Microsoft Docs: + Filtering options during texture sampling. - Microsoft Docs: + + Microsoft Docs: + @@ -579,79 +808,125 @@ The size value in StructureByteStride must match the size of the format t Use anisotropic interpolation for minification, magnification, and mip-level sampling. Compare the result to the comparison value. - Fetch the same set of texels as D3D11_FILTER_MIN_MAG_MIP_POINT and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_MAG_MIP_POINT and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_MAG_POINT_MIP_LINEAR and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_MAG_POINT_MIP_LINEAR and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_POINT_MAG_LINEAR_MIP_POINT and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_POINT_MAG_LINEAR_MIP_POINT and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_POINT_MAG_MIP_LINEAR and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_POINT_MAG_MIP_LINEAR and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_LINEAR_MAG_MIP_POINT and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_LINEAR_MAG_MIP_POINT and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_LINEAR_MAG_POINT_MIP_LINEAR and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_LINEAR_MAG_POINT_MIP_LINEAR and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_MAG_LINEAR_MIP_POINT and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_MAG_LINEAR_MIP_POINT and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_MAG_MIP_LINEAR and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_MAG_MIP_LINEAR and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_ANISOTROPIC and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_ANISOTROPIC and instead of filtering them return the minimum of the texels. Texels that are weighted 0 during filtering aren't counted towards the minimum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_MAG_MIP_POINT and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_MAG_MIP_POINT and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_MAG_POINT_MIP_LINEAR and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_MAG_POINT_MIP_LINEAR and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_POINT_MAG_LINEAR_MIP_POINT and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_POINT_MAG_LINEAR_MIP_POINT and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_POINT_MAG_MIP_LINEAR and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_POINT_MAG_MIP_LINEAR and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_LINEAR_MAG_MIP_POINT and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_LINEAR_MAG_MIP_POINT and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_LINEAR_MAG_POINT_MIP_LINEAR and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_LINEAR_MAG_POINT_MIP_LINEAR and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_MAG_LINEAR_MIP_POINT and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_MAG_LINEAR_MIP_POINT and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_MIN_MAG_MIP_LINEAR and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_MIN_MAG_MIP_LINEAR and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + - Fetch the same set of texels as D3D11_FILTER_ANISOTROPIC and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + + Fetch the same set of texels as D3D11_FILTER_ANISOTROPIC and instead of filtering them return the maximum of the texels. Texels that are weighted 0 during filtering aren't counted towards the maximum. You can query support for this filter type from the MinMaxFiltering member in the D3D11_FEATURE_DATA_D3D11_OPTIONS1 structure. + Copy a region from a source resource to a destination resource. - Microsoft Docs: - A pointer to the destination resource (see ID3D11Resource). + + Microsoft Docs: + + + A pointer to the destination resource (see ID3D11Resource). + Destination subresource index. The x-coordinate of the upper left corner of the destination region. The y-coordinate of the upper left corner of the destination region. For a 1D subresource, this must be zero. The z-coordinate of the upper left corner of the destination region. For a 1D or 2D subresource, this must be zero. - A pointer to the source resource (see ID3D11Resource). + + A pointer to the source resource (see ID3D11Resource). + Source subresource index. - A pointer to a 3D box (see D3D11_BOX) that defines the source subresource that can be copied. If NULL, the entire source subresource is copied. The box must fit within the source resource. + + A pointer to a 3D box (see D3D11_BOX) that defines the source subresource that can be copied. If NULL, the entire source subresource is copied. The box must fit within the source resource. -An empty box results in a no-op. A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. When the box is empty, CopySubresourceRegion doesn't perform a copy operation. + An empty box results in a no-op. A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. When the box is empty, CopySubresourceRegion doesn't perform a copy operation. + Values that specify minimum precision levels at shader stages. - Microsoft Docs: + + Microsoft Docs: + @@ -663,7 +938,9 @@ An empty box results in a no-op. A box is empty if the top value is greater than Describes a function. - Microsoft Docs: + + Microsoft Docs: + @@ -673,7 +950,9 @@ An empty box results in a no-op. A box is empty if the top value is greater than The name of the originator of the function. - A combination of D3DCOMPILE Constants that are combined by using a bitwise OR operation. The resulting value specifies shader compilation and parsing. + + A combination of D3DCOMPILE Constants that are combined by using a bitwise OR operation. The resulting value specifies shader compilation and parsing. + The number of constant buffers for the function. @@ -745,10 +1024,14 @@ An empty box results in a no-op. A box is empty if the top value is greater than The number of bitwise arithmetic instructions used by the function. - A D3D_FEATURE_LEVEL-typed value that specifies the minimum Direct3D feature level target of the function byte code. + + A D3D_FEATURE_LEVEL-typed value that specifies the minimum Direct3D feature level target of the function byte code. + - A value that contains a combination of one or more shader requirements flags; each flag specifies a requirement of the shader. A default value of 0 means there are no requirements. For a list of values, see ID3D11ShaderReflection::GetRequiresFlags. + + A value that contains a combination of one or more shader requirements flags; each flag specifies a requirement of the shader. A default value of 0 means there are no requirements. For a list of values, see ID3D11ShaderReflection::GetRequiresFlags. + The name of the function. @@ -757,41 +1040,57 @@ An empty box results in a no-op. A box is empty if the top value is greater than The number of logical parameters in the function signature, not including the return value. - Indicates whether the function returns a value. TRUE indicates it returns a value; otherwise, FALSE (it is a subroutine). + + Indicates whether the function returns a value. TRUE indicates it returns a value; otherwise, FALSE (it is a subroutine). + - Indicates whether there is a Direct3D 10Level9 vertex shader blob. TRUE indicates there is a 10Level9 vertex shader blob; otherwise, FALSE. + + Indicates whether there is a Direct3D 10Level9 vertex shader blob. TRUE indicates there is a 10Level9 vertex shader blob; otherwise, FALSE. + - Indicates whether there is a Direct3D 10Level9 pixel shader blob. TRUE indicates there is a 10Level9 pixel shader blob; otherwise, FALSE. + + Indicates whether there is a Direct3D 10Level9 pixel shader blob. TRUE indicates there is a 10Level9 pixel shader blob; otherwise, FALSE. + Gets a handle to the authenticated channel. - Microsoft Docs: + + Microsoft Docs: + Receives a handle to the channel. Gets the number of Movc instructions. - Microsoft Docs: + + Microsoft Docs: + A 3D texture interface accesses texel data, which is structured memory. - Microsoft Docs: + + Microsoft Docs: + Contains input data for a D3D11_AUTHENTICATED_QUERY_ENCRYPTION_WHEN_ACCESSIBLE_GUID query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_INPUT structure that contains the GUID for the query and other data. + + A D3D11_AUTHENTICATED_QUERY_INPUT structure that contains the GUID for the query and other data. + The index of the encryption GUID. @@ -799,14 +1098,20 @@ An empty box results in a no-op. A box is empty if the top value is greater than Represents key exchange output data for hardware content protection. - Microsoft Docs: + + Microsoft Docs: + - The size of the private data reserved for IHV usage. This size is determined from the pPrivateOutputSize parameter returned by the ID3D11VideoDevice1::GetCryptoSessionPrivateDataSize function. + + The size of the private data reserved for IHV usage. This size is determined from the pPrivateOutputSize parameter returned by the ID3D11VideoDevice1::GetCryptoSessionPrivateDataSize function. + - The maximum size of data that the driver can return in the output buffer. The last byte that it can write to is pbOuput[PrivateDataSize + MaxHWProtectionDataSize – 1]. + + The maximum size of data that the driver can return in the output buffer. The last byte that it can write to is pbOuput[PrivateDataSize + MaxHWProtectionDataSize – 1]. + The size of the output data written by the driver. @@ -818,25 +1123,37 @@ An empty box results in a no-op. A box is empty if the top value is greater than The number of 100 nanosecond units spent executing the content protection command. - If PrivateDataSize is greater than 0, pbInput[0] – pbOutput[PrivateDataSize - 1] is reserved for IHV use. + + If PrivateDataSize is greater than 0, pbInput[0] – pbOutput[PrivateDataSize - 1] is reserved for IHV use. -pbOutput[PrivateDataSize] – pbOutput[HWProtectionDataSize + PrivateDataSize - 1] contains the input data for the DRM command. The format and size of the DRM command is defined by the DRM specification. + pbOutput[PrivateDataSize] – pbOutput[HWProtectionDataSize + PrivateDataSize - 1] contains the input data for the DRM command. The format and size of the DRM command is defined by the DRM specification. + Allows the driver to recommend optimal output downsample parameters from the input parameters. - Microsoft Docs: - A D3D11_VIDEO_DECODER_DESC object describing the decoding profile, the resolution, and format of the input stream. This is the resolution and format to be downsampled. - A DXGI_COLOR_SPACE_TYPE value that specifies the colorspace of the reference frame data. + + Microsoft Docs: + + + A D3D11_VIDEO_DECODER_DESC object describing the decoding profile, the resolution, and format of the input stream. This is the resolution and format to be downsampled. + + + A DXGI_COLOR_SPACE_TYPE value that specifies the colorspace of the reference frame data. + The configuration data associated with the decode profile. The frame rate of the video content. This is used by the driver to determine whether the video can be decoded in real-time. - Pointer to a D3D11_VIDEO_SAMPLE_DESC structure that the driver populates with the recommended output buffer parameters for a downsample operation. The driver will attempt to recommend parameters that can support real-time decoding. If it is unable to do so, the driver will recommend values that are as close to the real-time solution as possible. + + Pointer to a D3D11_VIDEO_SAMPLE_DESC structure that the driver populates with the recommended output buffer parameters for a downsample operation. The driver will attempt to recommend parameters that can support real-time decoding. If it is unable to do so, the driver will recommend values that are as close to the real-time solution as possible. + Associate an IUnknown-derived interface with this device child and associate that interface with an application-defined guid. - Microsoft Docs: + + Microsoft Docs: + Guid associated with the interface. Pointer to an IUnknown-derived interface to be associated with the device child. @@ -844,14 +1161,20 @@ An empty box results in a no-op. A box is empty if the top value is greater than Get the properties of the texture resource. - Microsoft Docs: - Pointer to a resource description (see D3D11_TEXTURE3D_DESC). + + Microsoft Docs: + + + Pointer to a resource description (see D3D11_TEXTURE3D_DESC). + Draw indexed, non-instanced primitives. - Microsoft Docs: + + Microsoft Docs: + Number of indices to draw. The location of the first index read by the GPU from the index buffer. A value added to each index before reading a vertex from the vertex buffer. @@ -860,7 +1183,9 @@ An empty box results in a no-op. A box is empty if the top value is greater than Specifies the subresources from a multisampled 2D texture to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + @@ -869,26 +1194,38 @@ An empty box results in a no-op. A box is empty if the top value is greater than Get the eviction priority of a resource. - Microsoft Docs: + + Microsoft Docs: + Creates a deferred context, which can record command lists. - Microsoft Docs: - Reserved for future use. - Pass 0. - Upon completion of the method, the passed pointer to an ID3D11DeviceContext1 interface pointer is initialized. + + Microsoft Docs: + + + Reserved for future use. + Pass 0. + + + Upon completion of the method, the passed pointer to an ID3D11DeviceContext1 interface pointer is initialized. + Identifies a type of trace register. - Microsoft Docs: + + Microsoft Docs: + - Output NULL register. + + Output NULL register. + Input register. @@ -998,84 +1335,125 @@ An empty box results in a no-op. A box is empty if the top value is greater than Writes encrypted data to a protected surface. - Microsoft Docs: - A pointer to the ID3D11CryptoSession interface. + + Microsoft Docs: + + + A pointer to the ID3D11CryptoSession interface. + A pointer to the surface that contains the source data. A pointer to the protected surface where the encrypted data is written. - A pointer to a D3D11_ENCRYPTED_BLOCK_INFO structure, or NULL. + + A pointer to a D3D11_ENCRYPTED_BLOCK_INFO structure, or NULL. -If the driver supports partially encrypted buffers, pEncryptedBlockInfo indicates which portions of the buffer are encrypted. If the entire surface is encrypted, set this parameter to NULL. + If the driver supports partially encrypted buffers, pEncryptedBlockInfo indicates which portions of the buffer are encrypted. If the entire surface is encrypted, set this parameter to NULL. -To check whether the driver supports partially encrypted buffers, call ID3D11VideoDevice::GetContentProtectionCaps and check for the D3D11_CONTENT_PROTECTION_CAPS_PARTIAL_DECRYPTION - capabilities flag. If the driver does not support partially encrypted buffers, set this parameter to NULL. + To check whether the driver supports partially encrypted buffers, call ID3D11VideoDevice::GetContentProtectionCaps and check for the + D3D11_CONTENT_PROTECTION_CAPS_PARTIAL_DECRYPTION + capabilities flag. If the driver does not support partially encrypted buffers, set this parameter to NULL. + The size of the encrypted content key, in bytes. - A pointer to a buffer that contains a content encryption key, or NULL. To query whether the driver supports the use of content keys, call ID3D11VideoDevice::GetContentProtectionCaps and check for the D3D11_CONTENT_PROTECTION_CAPS_CONTENT_KEY capabilities flag. + + A pointer to a buffer that contains a content encryption key, or NULL. To query whether the driver supports the use of content keys, call ID3D11VideoDevice::GetContentProtectionCaps and check for the D3D11_CONTENT_PROTECTION_CAPS_CONTENT_KEY capabilities flag. -If the driver supports content keys, use the content key to encrypt the surface. Encrypt the content key using the session key, and place the resulting cipher text in pContentKey. If the driver does not support content keys, use the session key to encrypt the surface and set pContentKey to NULL. - The size of the pIV buffer, in bytes. - A pointer to a buffer that contains the initialization vector (IV). + If the driver supports content keys, use the content key to encrypt the surface. Encrypt the content key using the session key, and place the resulting cipher text in pContentKey. If the driver does not support content keys, use the session key to encrypt the surface and set pContentKey to NULL. + + + The size of the pIV buffer, in bytes. + + + A pointer to a buffer that contains the initialization vector (IV). -For 128-bit AES-CTR encryption, pIV points to a D3D11_AES_CTR_IV structure. The caller allocates the structure and generates the IV. When you generate the first IV, initialize the structure to a random number. For each subsequent IV, simply increment the IV member of the structure, ensuring that the value always increases. This procedure enables the driver to validate that the same IV is never used more than once with the same key pair. + For 128-bit AES-CTR encryption, pIV points to a D3D11_AES_CTR_IV structure. The caller allocates the structure and generates the IV. When you generate the first IV, initialize the structure to a random number. For each subsequent IV, simply increment the IV member of the structure, ensuring that the value always increases. This procedure enables the driver to validate that the same IV is never used more than once with the same key pair. -For other encryption types, a different structure might be used, or the encryption might not use an IV. + For other encryption types, a different structure might be used, or the encryption might not use an IV. + Identifies how to view a buffer resource. - Microsoft Docs: + + Microsoft Docs: + - View the buffer as raw. For more info about raw viewing of buffers, see Raw Views of Buffers. + + View the buffer as raw. For more info about raw viewing of buffers, see Raw Views of Buffers. + Get the depth-stencil view. - Microsoft Docs: - Pointer to a depth-stencil-view description (see D3D11_DEPTH_STENCIL_VIEW_DESC). + + Microsoft Docs: + + + Pointer to a depth-stencil-view description (see D3D11_DEPTH_STENCIL_VIEW_DESC). + Describes an instance of a compute shader to trace. - Microsoft Docs: + + Microsoft Docs: + The invocation number of the instance of the compute shader. - The SV_GroupThreadID to trace. This value identifies indexes of individual threads within a thread group that a compute shader executes in. + + The SV_GroupThreadID to trace. This value identifies indexes of individual threads within a thread group that a compute shader executes in. + - The SV_GroupID to trace. This value identifies indexes of a thread group that the compute shader executes in. + + The SV_GroupID to trace. This value identifies indexes of a thread group that the compute shader executes in. + This method creates D3D11 resources for use with D3D 11on12. - Microsoft Docs: + + Microsoft Docs: + A pointer to an already-created D3D12 resource or heap. - A D3D11_RESOURCE_FLAGS structure that enables an application to override flags that would be inferred by the resource/heap properties. - The D3D11_RESOURCE_FLAGS structure contains bind flags, misc flags, and CPU access flags. - The use of the resource on input, as a bitwise-OR'd combination of D3D12_RESOURCE_STATES enumeration constants. - The use of the resource on output, as a bitwise-OR'd combination of D3D12_RESOURCE_STATES enumeration constants. - The globally unique identifier (GUID) for the wrapped resource interface. - The REFIID, or GUID, of the interface to the wrapped resource can be obtained by using the __uuidof() macro. - For example, __uuidof(ID3D12Resource) will get the GUID of the interface to a wrapped resource. + + A D3D11_RESOURCE_FLAGS structure that enables an application to override flags that would be inferred by the resource/heap properties. + The D3D11_RESOURCE_FLAGS structure contains bind flags, misc flags, and CPU access flags. + + + The use of the resource on input, as a bitwise-OR'd combination of D3D12_RESOURCE_STATES enumeration constants. + + + The use of the resource on output, as a bitwise-OR'd combination of D3D12_RESOURCE_STATES enumeration constants. + + + The globally unique identifier (GUID) for the wrapped resource interface. + The REFIID, or GUID, of the interface to the wrapped resource can be obtained by using the __uuidof() macro. + For example, __uuidof(ID3D12Resource) will get the GUID of the interface to a wrapped resource. + After the method returns, points to the newly created wrapped D3D11 resource or heap. Gets the current value of the fence. - Microsoft Docs: + + Microsoft Docs: + Rebinds a texture or buffer by name to destination slots. - Microsoft Docs: + + Microsoft Docs: + The name of the texture or buffer for rebinding. The first destination slot number for rebinding. The number of slots for rebinding. @@ -1084,21 +1462,33 @@ For other encryption types, a different structure might be used, or the encrypti A domain-shader interface manages an executable program (a domain shader) that controls the domain-shader stage. - Microsoft Docs: + + Microsoft Docs: + Gives a device access to a shared resource that is referenced by name and that was created on a different device. - Microsoft Docs: - The name of the resource to open. This parameter cannot be NULL. - The requested access rights to the resource. In addition to the generic access rights, DXGI defines the following values: + + Microsoft Docs: + + + The name of the resource to open. This parameter cannot be NULL. + + + The requested access rights to the resource. In addition to the generic access rights, DXGI defines the following values: -
    -
  • DXGI_SHARED_RESOURCE_READ ( 0x80000000L ) - specifies read access to the resource.
    • -
  • DXGI_SHARED_RESOURCE_WRITE ( 1 ) - specifies write access to the resource.
    • -
-You can combine values by using a bitwise OR operation. +
    +
  • + DXGI_SHARED_RESOURCE_READ ( 0x80000000L ) - specifies read access to the resource. +
    • +
  • + DXGI_SHARED_RESOURCE_WRITE ( 1 ) - specifies write access to the resource. +
    • +
+ You can combine values by using a bitwise OR operation. + The globally unique identifier (GUID) for the resource interface. For more info, see Remarks. A pointer to a variable that receives a pointer to the interface for the shared resource object to access. @@ -1106,22 +1496,30 @@ You can combine values by using a bitwise OR operation. The depth-stencil-state interface holds a description for depth-stencil state that you can bind to the output-merger stage. - Microsoft Docs: + + Microsoft Docs: + Specifies the subresources from an array of 2D textures to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + - Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original Texture2D for which ID3D11Device::CreateShaderResourceView creates a view) -1. + + Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original Texture2D for which ID3D11Device::CreateShaderResourceView creates a view) -1. + - The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. + + The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. -Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + The index of the first texture to use in an array of textures. @@ -1132,137 +1530,205 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Checks the status of a crypto session. - Microsoft Docs: - Specifies a ID3D11CryptoSession for which status is checked. + + Microsoft Docs: + + + Specifies a ID3D11CryptoSession for which status is checked. + A D3D11_CRYPTO_SESSION_STATUS that is populated with the crypto session status upon completion. Describes Direct3D 11.2 feature options in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether the hardware and driver support tiled resources. The runtime sets this member to a D3D11_TILED_RESOURCES_TIER-typed value that indicates if the hardware and driver support tiled resources and at what tier level. + + Specifies whether the hardware and driver support tiled resources. The runtime sets this member to a D3D11_TILED_RESOURCES_TIER-typed value that indicates if the hardware and driver support tiled resources and at what tier level. + - Specifies whether the hardware and driver support the filtering options (D3D11_FILTER) of comparing the result to the minimum or maximum value during texture sampling. The runtime sets this member to TRUE if the hardware and driver support these filtering options. + + Specifies whether the hardware and driver support the filtering options (D3D11_FILTER) of comparing the result to the minimum or maximum value during texture sampling. The runtime sets this member to TRUE if the hardware and driver support these filtering options. + - Specifies whether the hardware and driver also support the ID3D11DeviceContext1::ClearView method on depth formats. For info about valid depth formats, see D3D11_DEPTH_STENCIL_VIEW_DESC. + + Specifies whether the hardware and driver also support the ID3D11DeviceContext1::ClearView method on depth formats. For info about valid depth formats, see D3D11_DEPTH_STENCIL_VIEW_DESC. + - Specifies support for creating ID3D11Buffer resources that can be passed to the ID3D11DeviceContext::Map and ID3D11DeviceContext::Unmap methods. This means that the CPUAccessFlags member of the D3D11_BUFFER_DESC structure may be set with the desired D3D11_CPU_ACCESS_FLAG elements when the Usage member of D3D11_BUFFER_DESC is set to D3D11_USAGE_DEFAULT. The runtime sets this member to TRUE if the hardware is capable of at least D3D_FEATURE_LEVEL_11_0 and the graphics device driver supports mappable default buffers. + + Specifies support for creating ID3D11Buffer resources that can be passed to the ID3D11DeviceContext::Map and ID3D11DeviceContext::Unmap methods. This means that the CPUAccessFlags member of the D3D11_BUFFER_DESC structure may be set with the desired D3D11_CPU_ACCESS_FLAG elements when the Usage member of D3D11_BUFFER_DESC is set to D3D11_USAGE_DEFAULT. The runtime sets this member to TRUE if the hardware is capable of at least D3D_FEATURE_LEVEL_11_0 and the graphics device driver supports mappable default buffers. + An unordered-access-view interface represents the parts of a resource the pipeline can access during rendering. - Microsoft Docs: + + Microsoft Docs: + Create a pixel shader. - Microsoft Docs: + + Microsoft Docs: + A pointer to the compiled shader. Size of the compiled pixel shader. - A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. - Address of a pointer to a ID3D11PixelShader interface. If this is NULL, all other parameters will be validated, and if all parameters pass validation this API will return S_FALSE instead of S_OK. + + A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. + + + Address of a pointer to a ID3D11PixelShader interface. If this is NULL, all other parameters will be validated, and if all parameters pass validation this API will return S_FALSE instead of S_OK. + Gets the parameters that were used to create the decoder. - Microsoft Docs: - A pointer to a D3D11_VIDEO_DECODER_DESC structure that receives a description of the video stream. - A pointer to a D3D11_VIDEO_DECODER_CONFIG structure that receives the decoder configuration. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_DECODER_DESC structure that receives a description of the video stream. + + + A pointer to a D3D11_VIDEO_DECODER_CONFIG structure that receives the decoder configuration. + Creates a device that represents the display adapter and a swap chain used for rendering. - Microsoft Docs: - A pointer to the video adapter to use when creating a device. Pass NULL to use the default adapter, which is the first adapter enumerated - by IDXGIFactory1::EnumAdapters. + + Microsoft Docs: + + + A pointer to the video adapter to use when creating a device. Pass NULL to use the default adapter, which is the first adapter enumerated + by IDXGIFactory1::EnumAdapters. -
Note  Do not mix the use of DXGI 1.0 (IDXGIFactory) and DXGI 1.1 (IDXGIFactory1) in an application. Use IDXGIFactory or IDXGIFactory1, but not both in an application. -
-
 
- The D3D_DRIVER_TYPE, which represents the driver type to create. - A handle to a DLL that implements a software rasterizer. - If DriverType is D3D_DRIVER_TYPE_SOFTWARE, Software must not be NULL. Get the handle by - calling LoadLibrary, - LoadLibraryEx , - or GetModuleHandle. The value should be non-NULLwhen D3D_DRIVER_TYPE is D3D_DRIVER_TYPE_SOFTWARE and NULL otherwise. - The runtime layers to enable (see D3D11_CREATE_DEVICE_FLAG); - values can be bitwise OR'd together. - A pointer to an array of D3D_FEATURE_LEVELs, which determine the order of feature levels to attempt to create. - If pFeatureLevels is set to NULL, - this function uses the following array of feature levels: - +
+ Note  Do not mix the use of DXGI 1.0 (IDXGIFactory) and DXGI 1.1 (IDXGIFactory1) in an application. Use IDXGIFactory or IDXGIFactory1, but not both in an application. +
+
 
+ + + The D3D_DRIVER_TYPE, which represents the driver type to create. + + + A handle to a DLL that implements a software rasterizer. + If DriverType is D3D_DRIVER_TYPE_SOFTWARE, Software must not be NULL. Get the handle by + calling LoadLibrary, + LoadLibraryEx , + or GetModuleHandle. The value should be non-NULLwhen D3D_DRIVER_TYPE is D3D_DRIVER_TYPE_SOFTWARE and NULL otherwise. + + + The runtime layers to enable (see D3D11_CREATE_DEVICE_FLAG); + values can be bitwise OR'd together. + + + A pointer to an array of D3D_FEATURE_LEVELs, which determine the order of feature levels to attempt to create. + If pFeatureLevels is set to NULL, + this function uses the following array of feature levels: - -{ - D3D_FEATURE_LEVEL_11_0, - D3D_FEATURE_LEVEL_10_1, - D3D_FEATURE_LEVEL_10_0, - D3D_FEATURE_LEVEL_9_3, - D3D_FEATURE_LEVEL_9_2, - D3D_FEATURE_LEVEL_9_1, -}; - - + + + { + D3D_FEATURE_LEVEL_11_0, + D3D_FEATURE_LEVEL_10_1, + D3D_FEATURE_LEVEL_10_0, + D3D_FEATURE_LEVEL_9_3, + D3D_FEATURE_LEVEL_9_2, + D3D_FEATURE_LEVEL_9_1, + }; + + -
Note  If the Direct3D 11.1 runtime is present on the computer and pFeatureLevels is set to NULL, this function won't create a D3D_FEATURE_LEVEL_11_1 device. To create a D3D_FEATURE_LEVEL_11_1 device, you must explicitly provide a D3D_FEATURE_LEVEL array that includes D3D_FEATURE_LEVEL_11_1. If you provide a D3D_FEATURE_LEVEL array that contains D3D_FEATURE_LEVEL_11_1 on a computer that doesn't have the Direct3D 11.1 runtime installed, this function immediately fails with E_INVALIDARG. -
-
 
- The number of elements in pFeatureLevels. - The SDK version; use D3D11_SDK_VERSION. - A pointer to a swap chain description (see DXGI_SWAP_CHAIN_DESC) that contains initialization parameters for the swap chain. - Returns the address of a pointer to the IDXGISwapChain object that represents the swap chain used for rendering. - Returns the address of a pointer to an ID3D11Device object that represents the device created. If this parameter is NULL, no ID3D11Device will be returned'. - Returns a pointer to a D3D_FEATURE_LEVEL, which represents the first element in an array of feature levels supported - by the device. Supply NULL as an input if you don't need to determine which feature level is supported. - Returns the address of a pointer to an ID3D11DeviceContext object that represents the device context. If this parameter is NULL, no ID3D11DeviceContext will be returned. +
+ Note  If the Direct3D 11.1 runtime is present on the computer and pFeatureLevels is set to NULL, this function won't create a D3D_FEATURE_LEVEL_11_1 device. To create a D3D_FEATURE_LEVEL_11_1 device, you must explicitly provide a D3D_FEATURE_LEVEL array that includes D3D_FEATURE_LEVEL_11_1. If you provide a D3D_FEATURE_LEVEL array that contains D3D_FEATURE_LEVEL_11_1 on a computer that doesn't have the Direct3D 11.1 runtime installed, this function immediately fails with E_INVALIDARG. +
+
 
+ + + The number of elements in pFeatureLevels. + + + The SDK version; use D3D11_SDK_VERSION. + + + A pointer to a swap chain description (see DXGI_SWAP_CHAIN_DESC) that contains initialization parameters for the swap chain. + + + Returns the address of a pointer to the IDXGISwapChain object that represents the swap chain used for rendering. + + + Returns the address of a pointer to an ID3D11Device object that represents the device created. If this parameter is NULL, no ID3D11Device will be returned'. + + + Returns a pointer to a D3D_FEATURE_LEVEL, which represents the first element in an array of feature levels supported + by the device. Supply NULL as an input if you don't need to determine which feature level is supported. + + + Returns the address of a pointer to an ID3D11DeviceContext object that represents the device context. If this parameter is NULL, no ID3D11DeviceContext will be returned. + Get the number of quality levels available during multisampling. - Microsoft Docs: + + Microsoft Docs: + The texture format during multisampling. The number of samples during multisampling. - A combination of D3D11_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAGS values that are combined by using a bitwise OR operation. Currently, only D3D11_CHECK_MULTISAMPLE_QUALITY_LEVELS_TILED_RESOURCE is supported. + + A combination of D3D11_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAGS values that are combined by using a bitwise OR operation. Currently, only D3D11_CHECK_MULTISAMPLE_QUALITY_LEVELS_TILED_RESOURCE is supported. + A pointer to a variable the receives the number of quality levels supported by the adapter. See Remarks. Query information about the reliability of a timestamp query. - Microsoft Docs: + + Microsoft Docs: + How frequently the GPU counter increments in Hz. - If this is TRUE, something occurred in between the query's ID3D11DeviceContext::Begin and ID3D11DeviceContext::End calls that caused the timestamp counter to become discontinuous or disjoint, such as unplugging the AC cord on a laptop, overheating, or throttling up/down due to laptop savings events. The timestamp returned by ID3D11DeviceContext::GetData for a timestamp query is only reliable if Disjoint is FALSE. + + If this is TRUE, something occurred in between the query's ID3D11DeviceContext::Begin and ID3D11DeviceContext::End calls that caused the timestamp counter to become discontinuous or disjoint, such as unplugging the AC cord on a laptop, overheating, or throttling up/down due to laptop savings events. The timestamp returned by ID3D11DeviceContext::GetData for a timestamp query is only reliable if Disjoint is FALSE. + Sets the hardware protection state. - Microsoft Docs: + + Microsoft Docs: + Specifies whether to enable hardware protection. Describes the elements in a raw buffer resource to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + @@ -1272,19 +1738,27 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down The number of elements in the resource. - A D3D11_BUFFEREX_SRV_FLAG-typed value that identifies view options for the buffer. Currently, the only option is to identify a raw view of the buffer. For more info about raw viewing of buffers, see Raw Views of Buffers. + + A D3D11_BUFFEREX_SRV_FLAG-typed value that identifies view options for the buffer. Currently, the only option is to identify a raw view of the buffer. For more info about raw viewing of buffers, see Raw Views of Buffers. + Gets the properties of the texture resource. - Microsoft Docs: - A pointer to a D3D11_TEXTURE3D_DESC1 structure that receives the description of the 3D texture. + + Microsoft Docs: + + + A pointer to a D3D11_TEXTURE3D_DESC1 structure that receives the description of the 3D texture. + Contains flags that describe content-protection capabilities. - Microsoft Docs: + + Microsoft Docs: + @@ -1306,122 +1780,179 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down The driver can refresh the session key without renegotiating the key. - The driver can read back encrypted data from a protected surface. For more information, see ID3D11VideoContext::EncryptionBlt. + + The driver can read back encrypted data from a protected surface. For more information, see ID3D11VideoContext::EncryptionBlt. + The driver requires a separate key to read encrypted data from a protected surface. - If the encryption type is D3DCRYPTOTYPE_AES128_CTR, the application must use a sequential count in the D3D11_AES_CTR_IV structure. + + If the encryption type is D3DCRYPTOTYPE_AES128_CTR, the application must use a sequential count in the D3D11_AES_CTR_IV structure. + - The driver supports encrypted slice data, but does not support any other encrypted data in the compressed buffer. The caller should not encrypt any data within the buffer other than the slice data. + + The driver supports encrypted slice data, but does not support any other encrypted data in the compressed buffer. The caller should not encrypt any data within the buffer other than the slice data. -
Note  The driver should only report this flag for the specific profiles that have this limitation.
-
 
 +
+ Note  The driver should only report this flag for the specific profiles that have this limitation. +
+
 
+ The driver can copy encrypted data from one resource to another, decrypting the data as part of the process. - The hardware supports the protection of specific resources. This means that: + + The hardware supports the protection of specific resources. This means that: -
    -
  • The contents of a protected allocation can never be read by the CPU.
    • -
  • The hardware can ensure a protected resource cannot be copied to an unprotected resource.
    • -
-Note  This enumeration value is supported starting with Windows 10. +
    +
  • The contents of a protected allocation can never be read by the CPU.
    • +
  • The hardware can ensure a protected resource cannot be copied to an unprotected resource.
    • +
+ Note  This enumeration value is supported starting with Windows 10. + - Physical pages of a protected resource can be evicted and potentially paged to disk in low memory conditions without losing the contents of the resource when paged back in. + + Physical pages of a protected resource can be evicted and potentially paged to disk in low memory conditions without losing the contents of the resource when paged back in. -Note  This enumeration value is supported starting with Windows 10. + Note  This enumeration value is supported starting with Windows 10. + - The hardware supports an automatic teardown mechanism that could trigger hardware keys or protected content to become lost in some conditions. The application can register to be notified when these events occur. + + The hardware supports an automatic teardown mechanism that could trigger hardware keys or protected content to become lost in some conditions. The application can register to be notified when these events occur. -Note  This enumeration value is supported starting with Windows 10. + Note  This enumeration value is supported starting with Windows 10. + - The secure environment is tightly coupled with the GPU and an ID3D11CryptoSession should be used for communication between the user mode DRM component and the secure execution environment. + + The secure environment is tightly coupled with the GPU and an ID3D11CryptoSession should be used for communication between the user mode DRM component and the secure execution environment. -Note  This enumeration value is supported starting with Windows 10. + Note  This enumeration value is supported starting with Windows 10. + Gets the constant buffers that the pixel shader pipeline stage uses. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + Array of constant buffer interface pointers to be returned by the method. - A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. - A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + + A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. + + + A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + Gets the content description that was used to create this enumerator. - Microsoft Docs: - A pointer to a D3D11_VIDEO_PROCESSOR_CONTENT_DESC structure that receives the content description. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_PROCESSOR_CONTENT_DESC structure that receives the content description. + Flags that describe miscellaneous query behavior. - Microsoft Docs: + + Microsoft Docs: + - Tell the hardware that if it is not yet sure if something is hidden or not to draw it anyway. This is only used with an occlusion predicate. Predication data cannot be returned to your application via ID3D11DeviceContext::GetData when using this flag. + + Tell the hardware that if it is not yet sure if something is hidden or not to draw it anyway. This is only used with an occlusion predicate. Predication data cannot be returned to your application via ID3D11DeviceContext::GetData when using this flag. + Set a boolean that turns the debug output on or off. - Microsoft Docs: - Disable/Enable the debug output (TRUE to disable or mute the output, FALSE to enable the output). + + Microsoft Docs: + + + Disable/Enable the debug output (TRUE to disable or mute the output, FALSE to enable the output). + Specifies the alpha fill mode for video processing. - Microsoft Docs: + + Microsoft Docs: + Alpha values inside the target rectangle are set to opaque. - Alpha values inside the target rectangle are set to the alpha value specified in the background color. To set the background color, call the ID3D11VideoContext::VideoProcessorSetOutputBackgroundColor method. + + Alpha values inside the target rectangle are set to the alpha value specified in the background color. To set the background color, call the ID3D11VideoContext::VideoProcessorSetOutputBackgroundColor method. + Existing alpha values remain unchanged in the output surface. - Alpha values are taken from an input stream, scaled, and copied to the corresponding destination rectangle for that stream. The input stream is specified in the StreamIndex parameter of the ID3D11VideoContext::VideoProcessorSetOutputAlphaFillMode method. + + Alpha values are taken from an input stream, scaled, and copied to the corresponding destination rectangle for that stream. The input stream is specified in the StreamIndex parameter of the ID3D11VideoContext::VideoProcessorSetOutputAlphaFillMode method. -If the input stream does not have alpha data, the video processor sets the alpha values in the target rectangle to opaque. If the input stream is disabled or the source rectangle is empty, the alpha values in the target rectangle are not modified. + If the input stream does not have alpha data, the video processor sets the alpha values in the target rectangle to opaque. If the input stream is disabled or the source rectangle is empty, the alpha values in the target rectangle are not modified. + Gets a pointer to the data contained in a subresource, and denies the GPU access to that subresource. - Microsoft Docs: - A pointer to a ID3D11Resource interface. - Index number of the subresource. - A D3D11_MAP-typed value that specifies the CPU's read and write permissions for a resource. + + Microsoft Docs: + + + A pointer to a ID3D11Resource interface. + + + Index number of the subresource. + + + A D3D11_MAP-typed value that specifies the CPU's read and write permissions for a resource. + -Flag that specifies what the CPU does when the GPU is busy. This flag is optional. - A pointer to the D3D11_MAPPED_SUBRESOURCE structure for the mapped subresource. - See the Remarks section regarding NULL pointers. + Flag that specifies what the CPU does when the GPU is busy. This flag is optional. + + + A pointer to the D3D11_MAPPED_SUBRESOURCE structure for the mapped subresource. + See the Remarks section regarding NULL pointers. + Contains the response to a D3D11_AUTHENTICATED_QUERY_OUTPUT_ID query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + A handle to the device. @@ -1438,25 +1969,33 @@ If the input stream does not have alpha data, the video processor sets the alpha Gets a group of flags that indicates the requirements of a shader. - Microsoft Docs: + + Microsoft Docs: + Describes the subresources from an array of 2D textures to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + - Index of the most detailed mipmap level to use; this number is between 0 and ( MipLevels (from the original Texture2D for which - ID3D11Device3::CreateShaderResourceView1 - creates a view) - 1). + + Index of the most detailed mipmap level to use; this number is between 0 and ( MipLevels (from the original Texture2D for which + ID3D11Device3::CreateShaderResourceView1 + creates a view) - 1). + - The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. - + + The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. -Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + + Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + The index of the first texture to use in an array of textures. @@ -1470,31 +2009,47 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Identifies unordered-access view options for a buffer resource. - Microsoft Docs: + + Microsoft Docs: + - Resource contains raw, unstructured data. Requires the UAV format to be DXGI_FORMAT_R32_TYPELESS. - For more info about raw viewing of buffers, see Raw Views of Buffers. + + Resource contains raw, unstructured data. Requires the UAV format to be DXGI_FORMAT_R32_TYPELESS. + For more info about raw viewing of buffers, see Raw Views of Buffers. + - Allow data to be appended to the end of the buffer. D3D11_BUFFER_UAV_FLAG_APPEND flag must also be used for - any view that will be used as a AppendStructuredBuffer or a ConsumeStructuredBuffer. - Requires the UAV format to be DXGI_FORMAT_UNKNOWN. + + Allow data to be appended to the end of the buffer. D3D11_BUFFER_UAV_FLAG_APPEND flag must also be used for + any view that will be used as a AppendStructuredBuffer or a ConsumeStructuredBuffer. + Requires the UAV format to be DXGI_FORMAT_UNKNOWN. + - Adds a counter to the unordered-access-view buffer. D3D11_BUFFER_UAV_FLAG_COUNTER can only be used on a UAV that is a - RWStructuredBuffer and it enables the functionality needed for the IncrementCounterand DecrementCounter methods in HLSL. Requires the UAV format to be DXGI_FORMAT_UNKNOWN. + + Adds a counter to the unordered-access-view buffer. D3D11_BUFFER_UAV_FLAG_COUNTER can only be used on a UAV that is a + RWStructuredBuffer and it enables the functionality needed for the IncrementCounterand DecrementCounter methods in HLSL. Requires the UAV format to be DXGI_FORMAT_UNKNOWN. + The CPU copies data from memory to a subresource created in non-mappable memory. - Microsoft Docs: - A pointer to the destination resource (see ID3D11Resource). - A zero-based index, that identifies the destination subresource. See D3D11CalcSubresource for more details. - A pointer to a box that defines the portion of the destination subresource to copy the resource data into. Coordinates are in bytes for buffers and in texels for textures. If NULL, the data is written to the destination subresource with no offset. The dimensions of the source must fit the destination (see D3D11_BOX). + + Microsoft Docs: + + + A pointer to the destination resource (see ID3D11Resource). + + + A zero-based index, that identifies the destination subresource. See D3D11CalcSubresource for more details. + + + A pointer to a box that defines the portion of the destination subresource to copy the resource data into. Coordinates are in bytes for buffers and in texels for textures. If NULL, the data is written to the destination subresource with no offset. The dimensions of the source must fit the destination (see D3D11_BOX). -An empty box results in a no-op. A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. When the box is empty, UpdateSubresource doesn't perform an update operation. + An empty box results in a no-op. A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. When the box is empty, UpdateSubresource doesn't perform an update operation. + A pointer to the source data in memory. The size of one row of the source data. The size of one depth slice of source data. @@ -1503,26 +2058,38 @@ An empty box results in a no-op. A box is empty if the top value is greater than Gets the properties of the video processor input view. - Microsoft Docs: - A pointer to a D3D11_VIDEO_PROCESSOR_INPUT_VIEW_DESC structure. The method fills the structure with the view properties. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_PROCESSOR_INPUT_VIEW_DESC structure. The method fills the structure with the view properties. + Describes the multi-threading features that are supported by the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + - TRUE means resources can be created concurrently on multiple threads while drawing; FALSE means that the presence of coarse synchronization will prevent concurrency. + + TRUE means resources can be created concurrently on multiple threads while drawing; FALSE means that the presence of coarse synchronization will prevent concurrency. + - TRUE means command lists are supported by the current driver; FALSE means that the API will emulate deferred contexts and command lists with software. + + TRUE means command lists are supported by the current driver; FALSE means that the API will emulate deferred contexts and command lists with software. + Which resources are supported for a given format and given device (see ID3D11Device::CheckFormatSupport and ID3D11Device::CheckFeatureSupport). - Microsoft Docs: + + Microsoft Docs: + @@ -1550,20 +2117,29 @@ An empty box results in a no-op. A box is empty if the top value is greater than Cube texture resources supported. - The HLSL Load function for texture objects is supported. + + The HLSL Load function for texture objects is supported. + - The HLSL Sample function for texture objects is supported. + + The HLSL Sample function for texture objects is supported. -
Note  If the device supports the format as a resource (1D, 2D, 3D, or cube map) but doesn't support this option, the resource can still use the Sample method but must use only the point filtering sampler state to perform the sample.
-
 
 +
+ Note  If the device supports the format as a resource (1D, 2D, 3D, or cube map) but doesn't support this option, the resource can still use the Sample method but must use only the point filtering sampler state to perform the sample. +
+
 
+ - The HLSL SampleCmp and SampleCmpLevelZero functions for texture objects are supported. + + The HLSL SampleCmp and SampleCmpLevelZero functions for texture objects are supported. -
Note  Windows 8 and later might provide limited support for these functions on Direct3D feature levels 9_1, 9_2, and 9_3. For more info, see Implementing shadow buffers for Direct3D feature level 9. -
-
 
 +
+ Note  Windows 8 and later might provide limited support for these functions on Direct3D feature levels 9_1, 9_2, and 9_3. For more info, see Implementing shadow buffers for Direct3D feature level 9. +
+
 
+ Reserved. @@ -1587,7 +2163,9 @@ An empty box results in a no-op. A box is empty if the top value is greater than CPU locking supported. - Multisample antialiasing (MSAA) resolve operations are supported. For more info, see ID3D11DeviceContex::ResolveSubresource. + + Multisample antialiasing (MSAA) resolve operations are supported. For more info, see ID3D11DeviceContex::ResolveSubresource. + Format can be displayed on screen. @@ -1614,50 +2192,68 @@ An empty box results in a no-op. A box is empty if the top value is greater than Format can be used with the HLSL gather with comparison function. - Format can be used with the decoder output. + + Format can be used with the decoder output. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Format can be used with the video processor output. + + Format can be used with the video processor output. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Format can be used with the video processor input. + + Format can be used with the video processor input. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Format can be used with the video encoder. + + Format can be used with the video encoder. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + Identifies how to copy a tile. - Microsoft Docs: + + Microsoft Docs: + - Indicates that the GPU isn't currently referencing any of the - portions of destination memory being written. + + Indicates that the GPU isn't currently referencing any of the + portions of destination memory being written. + - Indicates that the ID3D11DeviceContext2::CopyTiles operation involves copying a linear buffer to a swizzled tiled resource. This means to copy tile data from the -specified buffer location, reading tiles sequentially, -to the specified tile region (in x,y,z order if the region is a box), swizzling to optimal hardware memory layout as needed. -In this ID3D11DeviceContext2::CopyTiles call, you specify the source data with the pBuffer parameter and the destination with the pTiledResource parameter. + + Indicates that the ID3D11DeviceContext2::CopyTiles operation involves copying a linear buffer to a swizzled tiled resource. This means to copy tile data from the + specified buffer location, reading tiles sequentially, + to the specified tile region (in x,y,z order if the region is a box), swizzling to optimal hardware memory layout as needed. + In this ID3D11DeviceContext2::CopyTiles call, you specify the source data with the pBuffer parameter and the destination with the pTiledResource parameter. + - Indicates that the ID3D11DeviceContext2::CopyTiles operation involves copying a swizzled tiled resource to a linear buffer. This means to copy tile data from the tile region, reading tiles sequentially (in x,y,z order if the region is a box), -to the specified buffer location, deswizzling to linear memory layout as needed. -In this ID3D11DeviceContext2::CopyTiles call, you specify the source data with the pTiledResource parameter and the destination with the pBuffer parameter. + + Indicates that the ID3D11DeviceContext2::CopyTiles operation involves copying a swizzled tiled resource to a linear buffer. This means to copy tile data from the tile region, reading tiles sequentially (in x,y,z order if the region is a box), + to the specified buffer location, deswizzling to linear memory layout as needed. + In this ID3D11DeviceContext2::CopyTiles call, you specify the source data with the pTiledResource parameter and the destination with the pBuffer parameter. + Describes an instance of a pixel shader to trace. - Microsoft Docs: + + Microsoft Docs: + @@ -1670,30 +2266,40 @@ In this ID3D11DeviceContext2::CopyTiles call, you specify the source data The y-coordinate of the pixel. - A value that describes a mask of pixel samples to trace. If this value specifies any of the masked samples, the trace is activated. The least significant bit (LSB) is sample 0. The non-multisample antialiasing (MSAA) counts as a sample count of 1; therefore, the LSB of SampleMask should be set. If set to zero, the pixel is not traced. However, pixel traces can still be enabled on an invocation basis. + + A value that describes a mask of pixel samples to trace. If this value specifies any of the masked samples, the trace is activated. The least significant bit (LSB) is sample 0. The non-multisample antialiasing (MSAA) counts as a sample count of 1; therefore, the LSB of SampleMask should be set. If set to zero, the pixel is not traced. However, pixel traces can still be enabled on an invocation basis. + The device context interface represents a device context; it is used to render commands. ID3D11DeviceContext2 adds new methods to those in ID3D11DeviceContext1. - Microsoft Docs: + + Microsoft Docs: + Get a bitfield of flags that indicates which debug features are on or off. - Microsoft Docs: + + Microsoft Docs: + Represents a fence, an object used for synchronization of the CPU and one or more GPUs. - Microsoft Docs: + + Microsoft Docs: + Retrieves the sizes, in units of threads, of the X, Y, and Z dimensions of the shader's thread-group grid. - Microsoft Docs: + + Microsoft Docs: + A pointer to the size, in threads, of the x-dimension of the thread-group grid. The maximum size is 1024. A pointer to the size, in threads, of the y-dimension of the thread-group grid. The maximum size is 1024. A pointer to the size, in threads, of the z-dimension of the thread-group grid. The maximum size is 64. @@ -1702,17 +2308,23 @@ In this ID3D11DeviceContext2::CopyTiles call, you specify the source data Describes depth-stencil state. - Microsoft Docs: + + Microsoft Docs: + Enable depth testing. - Identify a portion of the depth-stencil buffer that can be modified by depth data (see D3D11_DEPTH_WRITE_MASK). + + Identify a portion of the depth-stencil buffer that can be modified by depth data (see D3D11_DEPTH_WRITE_MASK). + - A function that compares depth data against existing depth data. The function options are listed in D3D11_COMPARISON_FUNC. + + A function that compares depth data against existing depth data. The function options are listed in D3D11_COMPARISON_FUNC. + Enable stencil testing. @@ -1724,97 +2336,143 @@ In this ID3D11DeviceContext2::CopyTiles call, you specify the source data Identify a portion of the depth-stencil buffer for writing stencil data. - Identify how to use the results of the depth test and the stencil test for pixels whose surface normal is facing towards the camera (see D3D11_DEPTH_STENCILOP_DESC). + + Identify how to use the results of the depth test and the stencil test for pixels whose surface normal is facing towards the camera (see D3D11_DEPTH_STENCILOP_DESC). + - Identify how to use the results of the depth test and the stencil test for pixels whose surface normal is facing away from the camera (see D3D11_DEPTH_STENCILOP_DESC). + + Identify how to use the results of the depth test and the stencil test for pixels whose surface normal is facing away from the camera (see D3D11_DEPTH_STENCILOP_DESC). + Create a blend-state object that encapsules blend state for the output-merger stage. - Microsoft Docs: - Pointer to a blend-state description (see D3D11_BLEND_DESC). - Address of a pointer to the blend-state object created (see ID3D11BlendState). + + Microsoft Docs: + + + Pointer to a blend-state description (see D3D11_BLEND_DESC). + + + Address of a pointer to the blend-state object created (see ID3D11BlendState). + Gets an immediate context, which can play back command lists. - Microsoft Docs: - Upon completion of the method, the passed pointer to an ID3D11DeviceContext1 interface pointer is initialized. + + Microsoft Docs: + + + Upon completion of the method, the passed pointer to an ID3D11DeviceContext1 interface pointer is initialized. + Provides data for calls to ID3D11VideoDevice2::CheckFeatureSupport when the feature specified is D3D11_FEATURE_VIDEO_DECODER_HISTOGRAM. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_VIDEO_DECODER_DESC structure containing the decoder description for the decoder to be used with decode histogram. + + A D3D11_VIDEO_DECODER_DESC structure containing the decoder description for the decoder to be used with decode histogram. + - A bitwise OR combination of values from the D3D11_VIDEO_DECODER_HISTOGRAM_COMPONENT_FLAGS enumeration specifying the components of a DXGI_FORMAT for which histogram support will be queried. + + A bitwise OR combination of values from the D3D11_VIDEO_DECODER_HISTOGRAM_COMPONENT_FLAGS enumeration specifying the components of a DXGI_FORMAT for which histogram support will be queried. + The number of per component bins supported. This value must be greater than or equal to 64 and must be a power of 2 (e.g. 64, 128, 256, 512...). - The bit depth of the bin counter. The counter is always stored in a 32-bit value and therefore this value must specify 32 bits or less. The counter is stored in the lower bits of the 32-bit storage. The upper bits are set to zero. If the bin count exceeds this bit depth, the value is set to the maximum counter value. Valid values for CounterBitDepth are 16, 24, and 32. + + The bit depth of the bin counter. The counter is always stored in a 32-bit value and therefore this value must specify 32 bits or less. The counter is stored in the lower bits of the 32-bit storage. The upper bits are set to zero. If the bin count exceeds this bit depth, the value is set to the maximum counter value. Valid values for CounterBitDepth are 16, 24, and 32. + Bind an array of shader resources to the pixel shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting shader resources to (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). Number of shader resources to set. Up to a maximum of 128 slots are available for shader resources (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to set to the device. + + Array of shader resource view interfaces to set to the device. + Creates a device that uses Direct3D 11 functionality in Direct3D 12, specifying a pre-existing Direct3D 12 device to use for Direct3D 11 interop. - Microsoft Docs: + + Microsoft Docs: + Specifies a pre-existing Direct3D 12 device to use for Direct3D 11 interop. May not be NULL. - One or more bitwise OR'd flags from D3D11_CREATE_DEVICE_FLAG. These are the same flags as those used by D3D11CreateDeviceAndSwapChain. Specifies which runtime layers to enable. Flags must be compatible with device flags, and its NodeMask must be a subset of the NodeMask provided to the present API. - An array of any of the following: + + One or more bitwise OR'd flags from D3D11_CREATE_DEVICE_FLAG. These are the same flags as those used by D3D11CreateDeviceAndSwapChain. Specifies which runtime layers to enable. Flags must be compatible with device flags, and its NodeMask must be a subset of the NodeMask provided to the present API. + + + An array of any of the following: -
    -
  • D3D_FEATURE_LEVEL_12_1
    • -
  • D3D_FEATURE_LEVEL_12_0
    • -
  • D3D_FEATURE_LEVEL_11_1
    • -
  • D3D_FEATURE_LEVEL_11_0
    • -
  • D3D_FEATURE_LEVEL_10_1
    • -
  • D3D_FEATURE_LEVEL_10_0
    • -
  • D3D_FEATURE_LEVEL_9_3
    • -
  • D3D_FEATURE_LEVEL_9_2
    • -
  • D3D_FEATURE_LEVEL_9_1
    • -
+
    +
  • D3D_FEATURE_LEVEL_12_1
    • +
  • D3D_FEATURE_LEVEL_12_0
    • +
  • D3D_FEATURE_LEVEL_11_1
    • +
  • D3D_FEATURE_LEVEL_11_0
    • +
  • D3D_FEATURE_LEVEL_10_1
    • +
  • D3D_FEATURE_LEVEL_10_0
    • +
  • D3D_FEATURE_LEVEL_9_3
    • +
  • D3D_FEATURE_LEVEL_9_2
    • +
  • D3D_FEATURE_LEVEL_9_1
    • +
-The first feature level that is less than or equal to the Direct3D 12 device's feature level will be used to perform Direct3D 11 validation. Creation will fail if no acceptable feature levels are provided. Providing NULL will default to the Direct3D 12 device's feature level. - The size of (that is, the number of elements in) the pFeatureLevels array. + The first feature level that is less than or equal to the Direct3D 12 device's feature level will be used to perform Direct3D 11 validation. Creation will fail if no acceptable feature levels are provided. Providing NULL will default to the Direct3D 12 device's feature level. + + + The size of (that is, the number of elements in) the pFeatureLevels array. + An array of unique queues for D3D11On12 to use. The queues must be of the 3D command queue type. - The size of (that is, the number of elements in) the ppCommandQueues array. + + The size of (that is, the number of elements in) the ppCommandQueues array. + Which node of the Direct3D 12 device to use. Only 1 bit may be set. - Pointer to the returned ID3D11Device. May be NULL. - A pointer to the returned ID3D11DeviceContext. May be NULL. + + Pointer to the returned ID3D11Device. May be NULL. + + + A pointer to the returned ID3D11DeviceContext. May be NULL. + A pointer to the returned feature level. May be NULL. Push an empty storage filter onto the storage-filter stack. - Microsoft Docs: + + Microsoft Docs: + Contains the response to a D3D11_AUTHENTICATED_QUERY_DEVICE_HANDLE query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + A handle to the device. @@ -1822,30 +2480,48 @@ The first feature level that is less than or equal to the Direct3D 12 device's f Retrieves information about a register that was read by a step in the trace. - Microsoft Docs: - The index of the step within the trace. The range of the index is [0...NumTraceSteps-1], where NumTraceSteps is a member of the D3D11_TRACE_STATS structure. You can retrieve information in any step order. - The index of the register within the trace step. The range of the index is [0...NumRegistersRead-1], where NumRegistersRead is a member of the D3D11_TRACE_STEP structure. - A pointer to a D3D11_TRACE_REGISTER structure. GetReadRegister fills the members of this structure with information about the register that was read by the step in the trace. - A pointer to a D3D11_TRACE_VALUE structure. GetReadRegister fills the members of this structure with information about the value that was read from the register. + + Microsoft Docs: + + + The index of the step within the trace. The range of the index is [0...NumTraceSteps-1], where NumTraceSteps is a member of the D3D11_TRACE_STATS structure. You can retrieve information in any step order. + + + The index of the register within the trace step. The range of the index is [0...NumRegistersRead-1], where NumRegistersRead is a member of the D3D11_TRACE_STEP structure. + + + A pointer to a D3D11_TRACE_REGISTER structure. GetReadRegister fills the members of this structure with information about the register that was read by the step in the trace. + + + A pointer to a D3D11_TRACE_VALUE structure. GetReadRegister fills the members of this structure with information about the value that was read from the register. + A 2D texture interface represents texel data, which is structured memory. - Microsoft Docs: + + Microsoft Docs: + Get the swap chain that the runtime will use for automatically calling IDXGISwapChain::Present. - Microsoft Docs: - Swap chain that the runtime will use for automatically calling IDXGISwapChain::Present. + + Microsoft Docs: + + + Swap chain that the runtime will use for automatically calling IDXGISwapChain::Present. + Set all the elements in a render target to one value. - Microsoft Docs: + + Microsoft Docs: + Pointer to the render target. A 4-component array that represents the color to fill the render target with. @@ -1853,116 +2529,185 @@ The first feature level that is less than or equal to the Direct3D 12 device's f Get the domain shader currently set on the device. - Microsoft Docs: - Address of a pointer to a domain shader (see ID3D11DomainShader) to be returned by the method. - Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + + Microsoft Docs: + + + Address of a pointer to a domain shader (see ID3D11DomainShader) to be returned by the method. + + + Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + The number of class-instance elements in the array. Get an array of sampler state interfaces from the compute-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into a zero-based array to begin getting samplers from (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers to get from a device context. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). + + Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). + Create a rasterizer state object that tells the rasterizer stage how to behave. - Microsoft Docs: - Pointer to a rasterizer state description (see D3D11_RASTERIZER_DESC). - Address of a pointer to the rasterizer state object created (see ID3D11RasterizerState). + + Microsoft Docs: + + + Pointer to a rasterizer state description (see D3D11_RASTERIZER_DESC). + + + Address of a pointer to the rasterizer state object created (see ID3D11RasterizerState). + Updates a fence to a specified value after all previous work has completed. - Microsoft Docs: - A pointer to the ID3D11Fence object. + + Microsoft Docs: + + + A pointer to the ID3D11Fence object. + The value to set the fence to. Resets the shader-trace object. - Microsoft Docs: + + Microsoft Docs: + Get the hull-shader resources. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin getting shader resources from (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). The number of resources to get from the device. Up to a maximum of 128 slots are available for shader resources (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to be returned by the device. + + Array of shader resource view interfaces to be returned by the device. + Sets the constant buffers used by the domain-shader stage. - Microsoft Docs: - Index into the zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffers (see ID3D11Buffer) being given to the device. + + Microsoft Docs: + + + Index into the zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). + + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + + Array of constant buffers (see ID3D11Buffer) being given to the device. + Gets the destination rectangle for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Receives the value TRUE if the destination rectangle is enabled, or FALSE otherwise. - A pointer to a RECT structure that receives the destination rectangle. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Receives the value TRUE if the destination rectangle is enabled, or FALSE otherwise. + + + A pointer to a RECT structure that receives the destination rectangle. + Gets the shader-resource view's description. - Microsoft Docs: - A pointer to a D3D11_SHADER_RESOURCE_VIEW_DESC1 structure that receives the description of the shader-resource view. + + Microsoft Docs: + + + A pointer to a D3D11_SHADER_RESOURCE_VIEW_DESC1 structure that receives the description of the shader-resource view. + Describes which unordered resource options are supported by the current graphics driver for a given format. - Microsoft Docs: + + Microsoft Docs: + -DXGI_FORMAT to return information on. + DXGI_FORMAT to return information on. + - Combination of D3D11_FORMAT_SUPPORT2 flags indicating which unordered resource options are supported. + + Combination of D3D11_FORMAT_SUPPORT2 flags indicating which unordered resource options are supported. + Gets the range of values for an image filter. - Microsoft Docs: - The type of image filter, specified as a D3D11_VIDEO_PROCESSOR_FILTER value. - A pointer to a D3D11_VIDEO_PROCESSOR_FILTER_RANGE structure. The method fills the structure with the range of values for the specified filter. + + Microsoft Docs: + + + The type of image filter, specified as a D3D11_VIDEO_PROCESSOR_FILTER value. + + + A pointer to a D3D11_VIDEO_PROCESSOR_FILTER_RANGE structure. The method fills the structure with the range of values for the specified filter. + Establishes a session key for an authenticated channel. - Microsoft Docs: - A pointer to the ID3D11AuthenticatedChannel interface. This method will fail if the channel type is D3D11_AUTHENTICATED_CHANNEL_D3D11, because the Direct3D11 channel does not support authentication. - The size of the data in the pData array, in bytes. + + Microsoft Docs: + + + A pointer to the ID3D11AuthenticatedChannel interface. This method will fail if the channel type is D3D11_AUTHENTICATED_CHANNEL_D3D11, because the Direct3D11 channel does not support authentication. + + + The size of the data in the pData array, in bytes. + A pointer to a byte array that contains the encrypted session key. The buffer must contain 256 bytes of data, encrypted using RSA Encryption Scheme - Optimal Asymmetric Encryption Padding (RSAES-OAEP). Contains the response to a D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS_COUNT query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + The number of processes that are allowed to open shared resources that have restricted access. A process cannot open such a resource unless the process has been granted access. @@ -1970,48 +2715,76 @@ The first feature level that is less than or equal to the Direct3D 12 device's f Gets the description for blending state that you used to create the blend-state object. - Microsoft Docs: - A pointer to a D3D11_BLEND_DESC structure that receives a description of the blend state. + + Microsoft Docs: + + + A pointer to a D3D11_BLEND_DESC structure that receives a description of the blend state. + Restore all default settings. - Microsoft Docs: + + Microsoft Docs: + A shader-resource-view interface represents the subresources a shader can access during rendering. Examples of shader resources include a constant buffer, a texture buffer, and a texture. - Microsoft Docs: + + Microsoft Docs: + Gets the constant buffers that the geometry shader pipeline stage uses. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + Array of constant buffer interface pointers to be returned by the method. - A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. - A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + + A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. + + + A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + Sets the constant buffers that the compute-shader stage uses. - Microsoft Docs: + + Microsoft Docs: + Index into the zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffers (see ID3D11Buffer) being given to the device. - An array that holds the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. Each offset must be a multiple of 16 constants. - An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + + Array of constant buffers (see ID3D11Buffer) being given to the device. + + + An array that holds the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. Each offset must be a multiple of 16 constants. + + + An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + Rebinds a texture or buffer from source slot to destination slot. - Microsoft Docs: + + Microsoft Docs: + The first source slot number for rebinding. The first destination slot number for rebinding. The number of slots for rebinding. @@ -2020,137 +2793,221 @@ The first feature level that is less than or equal to the Direct3D 12 device's f Indicates whether a shader is a sample frequency shader. - Microsoft Docs: + + Microsoft Docs: + Gets a constant buffer by index for a function. - Microsoft Docs: + + Microsoft Docs: + Zero-based index. Gets the image filter settings for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - The filter to query, specified as a D3D11_VIDEO_PROCESSOR_FILTER value. - Receives the value TRUE if the image filter is enabled, or FALSE otherwise. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + The filter to query, specified as a D3D11_VIDEO_PROCESSOR_FILTER value. + + + Receives the value TRUE if the image filter is enabled, or FALSE otherwise. + Receives the filter level. Gets the properties of the video decoder output view. - Microsoft Docs: - A pointer to a D3D11_VIDEO_DECODER_OUTPUT_VIEW_DESC structure. The method fills the structure with the view properties. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_DECODER_OUTPUT_VIEW_DESC structure. The method fills the structure with the view properties. + Create a counter object for measuring GPU performance. - Microsoft Docs: - Pointer to a counter description (see D3D11_COUNTER_DESC). - Address of a pointer to a counter (see ID3D11Counter). + + Microsoft Docs: + + + Pointer to a counter description (see D3D11_COUNTER_DESC). + + + Address of a pointer to a counter (see ID3D11Counter). + Check to see if the draw pipeline state is valid. - Microsoft Docs: - A pointer to the ID3D11DeviceContext, that represents a device context. + + Microsoft Docs: + + + A pointer to the ID3D11DeviceContext, that represents a device context. + Retrieves capabilities and limitations of the video decoder. - Microsoft Docs: + + Microsoft Docs: + The decode profile for which the capabilities are queried. The video width for which the capabilities are queried. The video height for which the capabilities are queried. The frame rate of the video content. This information is used by the driver to determine whether the video can be decoded in real-time. The bit rate of the video stream. A value of zero indicates that the bit rate can be ignored. The type of cryptography used to encrypt the video stream. A value of NULL indicates that the video stream is not encrypted. - A pointer to a bitwise OR combination of D3D11_VIDEO_DECODER_CAPS values specifying the decoder capabilities. + + A pointer to a bitwise OR combination of D3D11_VIDEO_DECODER_CAPS values specifying the decoder capabilities. + Gets the rate conversion capabilities of the video processor. - Microsoft Docs: - A pointer to a D3D11_VIDEO_PROCESSOR_RATE_CONVERSION_CAPS structure that receives the rate conversion capabilities. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_PROCESSOR_RATE_CONVERSION_CAPS structure that receives the rate conversion capabilities. + Releases D3D11 resources that were wrapped for D3D 11on12. - Microsoft Docs: - Specifies a pointer to a set of D3D11 resources, defined by ID3D11Resource. + + Microsoft Docs: + + + Specifies a pointer to a set of D3D11 resources, defined by ID3D11Resource. + Count of the number of resources. Push a storage filter onto the storage-filter stack. - Microsoft Docs: - Pointer to a storage filter (see D3D11_INFO_QUEUE_FILTER). + + Microsoft Docs: + + + Pointer to a storage filter (see D3D11_INFO_QUEUE_FILTER). + Describes double data type support in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether double types are allowed. If TRUE, double types are allowed; otherwise FALSE. The runtime must set DoublePrecisionFloatShaderOps to TRUE in order for you to use any HLSL shader that is compiled with a double type. + + Specifies whether double types are allowed. If TRUE, double types are allowed; otherwise FALSE. The runtime must set DoublePrecisionFloatShaderOps to TRUE in order for you to use any HLSL shader that is compiled with a double type. + Gets the pixel aspect ratio for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Receives the value TRUE if the pixel aspect ratio is specified. Otherwise, receives the value FALSE. - A pointer to a DXGI_RATIONAL structure. If *pEnabled is TRUE, this parameter receives the pixel aspect ratio of the source rectangle. - A pointer to a DXGI_RATIONAL structure. If *pEnabled is TRUE, this parameter receives the pixel aspect ratio of the destination rectangle. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Receives the value TRUE if the pixel aspect ratio is specified. Otherwise, receives the value FALSE. + + + A pointer to a DXGI_RATIONAL structure. If *pEnabled is TRUE, this parameter receives the pixel aspect ratio of the source rectangle. + + + A pointer to a DXGI_RATIONAL structure. If *pEnabled is TRUE, this parameter receives the pixel aspect ratio of the destination rectangle. + Set a domain shader to the device. - Microsoft Docs: - Pointer to a domain shader (see ID3D11DomainShader). Passing in NULL disables the shader for this pipeline stage. - A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + + Microsoft Docs: + + + Pointer to a domain shader (see ID3D11DomainShader). Passing in NULL disables the shader for this pipeline stage. + + + A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + The number of class-instance interfaces in the array. Gets the current level of downsampling that is performed by the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - Receives the value TRUE if downsampling was explicitly enabled using the ID3D11VideoContext::VideoProcessorSetOutputConstriction method. Receives the value FALSE if the downsampling was disabled or was never set. - If Enabled receives the value TRUE, this parameter receives the downsampling size. Otherwise, this parameter is ignored. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + Receives the value TRUE if downsampling was explicitly enabled using the ID3D11VideoContext::VideoProcessorSetOutputConstriction method. Receives the value FALSE if the downsampling was disabled or was never set. + + + If Enabled receives the value TRUE, this parameter receives the downsampling size. Otherwise, this parameter is ignored. + Gets a driver-specific state for a video processing stream. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + A pointer to a GUID that identifies the state. The meaning of this GUID is defined by the graphics driver. - The size of the pData buffer, in bytes. + + The size of the pData buffer, in bytes. + A pointer to a buffer that receives the private state data. Indicates whether the driver supports the specified combination of format and colorspace conversions. - Microsoft Docs: + + Microsoft Docs: + The format of the video processor input. The colorspace of the video processor input. The format of the video processor output. @@ -2161,151 +3018,163 @@ The first feature level that is less than or equal to the Direct3D 12 device's f Specifies the color space for video processing. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether the output is intended for playback or video processing (such as editing or authoring). The device can optimize the processing based on the type. The default state value is 0 (playback). + + Specifies whether the output is intended for playback or video processing (such as editing or authoring). The device can optimize the processing based on the type. The default state value is 0 (playback). - - - - - - - - + +
ValueMeaning
-
-
0
-
-		 -Playback + + + + + + + + - - - - + + + + - -
ValueMeaning
+
+
0
+
+ 		+ Playback -
-
-
1
-
-		 -Video processing +
+
+
1
+
+ 		+ Video processing -
+
+ - Specifies the RGB color range. The default state value is 0 (full range). + + Specifies the RGB color range. The default state value is 0 (full range). - - - - - - - - + +
ValueMeaning
-
-
0
-
-		 -Full range (0-255) + + + + + + + + - - - - + + + + - -
ValueMeaning
+
+
0
+
+ 		+ Full range (0-255) -
-
-
1
-
-		 -Limited range (16-235) +
+
+
1
+
+ 		+ Limited range (16-235) -
+
+ - Specifies the YCbCr transfer matrix. The default state value is 0 (BT.601). + + Specifies the YCbCr transfer matrix. The default state value is 0 (BT.601). - - - - - - - - + +
ValueMeaning
-
-
0
-
-		 -ITU-R BT.601 + + + + + + + + - - - - + + + + - -
ValueMeaning
+
+
0
+
+ 		+ ITU-R BT.601 -
-
-
1
-
-		 -ITU-R BT.709 +
+
+
1
+
+ 		+ ITU-R BT.709 -
+
+ - Specifies whether the output uses conventional YCbCr or extended YCbCr (xvYCC). The default state value is zero (conventional YCbCr). + + Specifies whether the output uses conventional YCbCr or extended YCbCr (xvYCC). The default state value is zero (conventional YCbCr). - - - - - - - - + +
ValueMeaning
-
-
0
-
-		 -Conventional YCbCr + + + + + + + + - - - - + + + + - -
ValueMeaning
+
+
0
+
+ 		+ Conventional YCbCr -
-
-
1
-
-		 -Extended YCbCr (xvYCC) +
+
+
1
+
+ 		+ Extended YCbCr (xvYCC) -
+
+ - Specifies the D3D11_VIDEO_PROCESSOR_NOMINAL_RANGE. + + Specifies the D3D11_VIDEO_PROCESSOR_NOMINAL_RANGE. -Introduced in Windows 8.1. + Introduced in Windows 8.1. + Reserved. Set to zero. @@ -2313,69 +3182,117 @@ Introduced in Windows 8.1. Gets the source rectangle for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Receives the value TRUE if the source rectangle is enabled, or FALSE otherwise. - A pointer to a RECT structure that receives the source rectangle. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Receives the value TRUE if the source rectangle is enabled, or FALSE otherwise. + + + A pointer to a RECT structure that receives the source rectangle. + Create a single 3D texture. - Microsoft Docs: - A pointer to a D3D11_TEXTURE3D_DESC structure that describes a 3D texture resource. To create a typeless resource that can be interpreted at runtime into different, compatible formats, specify a typeless format in the texture description. To generate mipmap levels automatically, set the number of mipmap levels to 0. - A pointer to an array of D3D11_SUBRESOURCE_DATA structures that describe subresources for the 3D texture resource. Applications cannot specify NULL for pInitialData when creating IMMUTABLE resources (see D3D11_USAGE). If the resource is multisampled, pInitialData must be NULL because multisampled resources cannot be initialized with data when they are created. + + Microsoft Docs: + + + A pointer to a D3D11_TEXTURE3D_DESC structure that describes a 3D texture resource. To create a typeless resource that can be interpreted at runtime into different, compatible formats, specify a typeless format in the texture description. To generate mipmap levels automatically, set the number of mipmap levels to 0. + + + A pointer to an array of D3D11_SUBRESOURCE_DATA structures that describe subresources for the 3D texture resource. Applications cannot specify NULL for pInitialData when creating IMMUTABLE resources (see D3D11_USAGE). If the resource is multisampled, pInitialData must be NULL because multisampled resources cannot be initialized with data when they are created. -If you don't pass anything to pInitialData, the initial content of the memory for the resource is undefined. In this case, you need to write the resource content some other way before the resource is read. + If you don't pass anything to pInitialData, the initial content of the memory for the resource is undefined. In this case, you need to write the resource content some other way before the resource is read. -You can determine the size of this array from the value in the MipLevels member of the D3D11_TEXTURE3D_DESC structure to which pDesc points. Arrays of 3D volume textures are not supported. + You can determine the size of this array from the value in the MipLevels member of the D3D11_TEXTURE3D_DESC structure to which pDesc points. Arrays of 3D volume textures are not supported. -For more information about this array size, see Remarks. - A pointer to a buffer that receives a pointer to a ID3D11Texture3D interface for the created texture. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + For more information about this array size, see Remarks. + + + A pointer to a buffer that receives a pointer to a ID3D11Texture3D interface for the created texture. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Gets the constant buffers that the vertex shader pipeline stage uses. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + Array of constant buffer interface pointers to be returned by the method. - A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. - A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + + A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. + + + A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + Sets the color-palette entries for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - The number of elements in the pEntries array. - A pointer to an array of palette entries. For RGB streams, the palette entries use the DXGI_FORMAT_B8G8R8A8 representation. For YCbCr streams, the palette entries use the DXGI_FORMAT_AYUV representation. The caller allocates the array. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + The number of elements in the pEntries array. + + + A pointer to an array of palette entries. For RGB streams, the palette entries use the DXGI_FORMAT_B8G8R8A8 representation. For YCbCr streams, the palette entries use the DXGI_FORMAT_AYUV representation. The caller allocates the array. + Get the pixel shader currently set on the device. - Microsoft Docs: - Address of a pointer to a pixel shader (see ID3D11PixelShader) to be returned by the method. - Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + + Microsoft Docs: + + + Address of a pointer to a pixel shader (see ID3D11PixelShader) to be returned by the method. + + + Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + The number of class-instance elements in the array. Get the exception-mode flags. - Microsoft Docs: - A value that contains one or more exception flags; each flag specifies a condition which will cause an exception to be raised. The flags are listed in D3D11_RAISE_FLAG. A default value of 0 means there are no flags. + + Microsoft Docs: + + + A value that contains one or more exception flags; each flag specifies a condition which will cause an exception to be raised. The flags are listed in D3D11_RAISE_FLAG. A default value of 0 means there are no flags. + Defines the dimensions of a viewport. - Microsoft Docs: + + Microsoft Docs: + @@ -2399,39 +3316,51 @@ For more information about this array size, see Remarks. Specifies video processing capabilities that relate to deinterlacing, inverse telecine (IVTC), and frame-rate conversion. - Microsoft Docs: + + Microsoft Docs: + - The video processor can perform blend deinterlacing. + + The video processor can perform blend deinterlacing. -In blend deinterlacing, the two fields from an interlaced frame are blended into a single progressive frame. A video processor uses blend deinterlacing when it deinterlaces at half rate, as when converting 60i to 30p. Blend deinterlacing does not require reference frames. + In blend deinterlacing, the two fields from an interlaced frame are blended into a single progressive frame. A video processor uses blend deinterlacing when it deinterlaces at half rate, as when converting 60i to 30p. Blend deinterlacing does not require reference frames. + - The video processor can perform bob deinterlacing. + + The video processor can perform bob deinterlacing. -In bob deinterlacing, missing field lines are interpolated from the lines above and below. Bob deinterlacing does not require reference frames. + In bob deinterlacing, missing field lines are interpolated from the lines above and below. Bob deinterlacing does not require reference frames. + - The video processor can perform adaptive deinterlacing. + + The video processor can perform adaptive deinterlacing. -Adaptive deinterlacing uses spatial or temporal interpolation, and switches between the two on a field-by-field basis, depending on the amount of motion. If the video processor does not receive enough reference frames to perform adaptive deinterlacing, it falls back to bob deinterlacing. + Adaptive deinterlacing uses spatial or temporal interpolation, and switches between the two on a field-by-field basis, depending on the amount of motion. If the video processor does not receive enough reference frames to perform adaptive deinterlacing, it falls back to bob deinterlacing. + - The video processor can perform motion-compensated deinterlacing. + + The video processor can perform motion-compensated deinterlacing. -Motion-compensated deinterlacing uses motion vectors to recreate missing lines. If the video processor does not receive enough reference frames to perform motion-compensated deinterlacing, it falls back to bob deinterlacing. + Motion-compensated deinterlacing uses motion vectors to recreate missing lines. If the video processor does not receive enough reference frames to perform motion-compensated deinterlacing, it falls back to bob deinterlacing. + - The video processor can perform inverse telecine (IVTC). + + The video processor can perform inverse telecine (IVTC). -If the video processor supports this capability, the ITelecineCaps member of the D3D11_VIDEO_PROCESSOR_RATE_CONVERSION_CAPS structure specifies which IVTC modes are supported. + If the video processor supports this capability, the ITelecineCaps member of the D3D11_VIDEO_PROCESSOR_RATE_CONVERSION_CAPS structure specifies which IVTC modes are supported. + The video processor can convert the frame rate by interpolating frames. @@ -2439,22 +3368,30 @@ If the video processor supports this capability, the ITelecineCaps member Get a shader-reflection-variable type. - Microsoft Docs: + + Microsoft Docs: + Zero-based index. Acquires D3D11 resources for use with D3D 11on12. Indicates that rendering to the wrapped resources can begin again. - Microsoft Docs: - Specifies a pointer to a set of D3D11 resources, defined by ID3D11Resource. + + Microsoft Docs: + + + Specifies a pointer to a set of D3D11 resources, defined by ID3D11Resource. + Count of the number of resources. Defines video processing capabilities for a Microsoft Direct3D 11 video processor. - Microsoft Docs: + + Microsoft Docs: + @@ -2470,14 +3407,18 @@ If the video processor supports this capability, the ITelecineCaps member The video processor can apply a matrix conversion to YCbCr values when the input and output are both YCbCr. For example, the driver can convert colors from BT.601 to BT.709. - The video processor supports YUV nominal range . + + The video processor supports YUV nominal range . -Supported in Windows 8.1 and later. + Supported in Windows 8.1 and later. + Stencil operations that can be performed based on the results of stencil test. - Microsoft Docs: + + Microsoft Docs: + @@ -2490,18 +3431,24 @@ Supported in Windows 8.1 and later. The stencil operation to perform when stencil testing and depth testing both pass. - A function that compares stencil data against existing stencil data. The function options are listed in D3D11_COMPARISON_FUNC. + + A function that compares stencil data against existing stencil data. The function options are listed in D3D11_COMPARISON_FUNC. + An input-layout interface holds a definition of how to feed vertex data that is laid out in memory into the input-assembler stage of the graphics pipeline. - Microsoft Docs: + + Microsoft Docs: + Specifies the type of process that is identified in the D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS_OUTPUT structure. - Microsoft Docs: + + Microsoft Docs: + @@ -2516,110 +3463,170 @@ Supported in Windows 8.1 and later. Get a shader-variable description. - Microsoft Docs: - A pointer to a shader-variable description (see D3D11_SHADER_VARIABLE_DESC). + + Microsoft Docs: + + + A pointer to a shader-variable description (see D3D11_SHADER_VARIABLE_DESC). + Create an array of 2D textures. - Microsoft Docs: - A pointer to a D3D11_TEXTURE2D_DESC structure that describes a 2D texture resource. To create a typeless resource that can be interpreted at runtime into different, compatible formats, specify a typeless format in the texture description. To generate mipmap levels automatically, set the number of mipmap levels to 0. - A pointer to an array of D3D11_SUBRESOURCE_DATA structures that describe subresources for the 2D texture resource. Applications can't specify NULL for pInitialData when creating IMMUTABLE resources (see D3D11_USAGE). If the resource is multisampled, pInitialData must be NULL because multisampled resources cannot be initialized with data when they are created. + + Microsoft Docs: + + + A pointer to a D3D11_TEXTURE2D_DESC structure that describes a 2D texture resource. To create a typeless resource that can be interpreted at runtime into different, compatible formats, specify a typeless format in the texture description. To generate mipmap levels automatically, set the number of mipmap levels to 0. + + + A pointer to an array of D3D11_SUBRESOURCE_DATA structures that describe subresources for the 2D texture resource. Applications can't specify NULL for pInitialData when creating IMMUTABLE resources (see D3D11_USAGE). If the resource is multisampled, pInitialData must be NULL because multisampled resources cannot be initialized with data when they are created. -If you don't pass anything to pInitialData, the initial content of the memory for the resource is undefined. In this case, you need to write the resource content some other way before the resource is read. + If you don't pass anything to pInitialData, the initial content of the memory for the resource is undefined. In this case, you need to write the resource content some other way before the resource is read. -You can determine the size of this array from values in the MipLevels and ArraySize members of the D3D11_TEXTURE2D_DESC structure to which pDesc points by using the following calculation: + You can determine the size of this array from values in the MipLevels and ArraySize members of the D3D11_TEXTURE2D_DESC structure to which pDesc points by using the following calculation: -MipLevels * ArraySize + MipLevels * ArraySize -For more information about this array size, see Remarks. - A pointer to a buffer that receives a pointer to a ID3D11Texture2D interface for the created texture. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + For more information about this array size, see Remarks. + + + A pointer to a buffer that receives a pointer to a ID3D11Texture2D interface for the created texture. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Specifies the subresources from a resource that are accessible using an unordered-access view. - Microsoft Docs: + + Microsoft Docs: + - The data format (see DXGI_FORMAT). + + The data format (see DXGI_FORMAT). + - The resource type (see D3D11_UAV_DIMENSION), which specifies how the resource will be accessed. + + The resource type (see D3D11_UAV_DIMENSION), which specifies how the resource will be accessed. + - Specifies which buffer elements can be accessed (see D3D11_BUFFER_UAV). + + Specifies which buffer elements can be accessed (see D3D11_BUFFER_UAV). + - Specifies the subresources in a 1D texture that can be accessed (see D3D11_TEX1D_UAV). + + Specifies the subresources in a 1D texture that can be accessed (see D3D11_TEX1D_UAV). + - Specifies the subresources in a 1D texture array that can be accessed (see D3D11_TEX1D_ARRAY_UAV). + + Specifies the subresources in a 1D texture array that can be accessed (see D3D11_TEX1D_ARRAY_UAV). + - Specifies the subresources in a 2D texture that can be accessed (see D3D11_TEX2D_UAV). + + Specifies the subresources in a 2D texture that can be accessed (see D3D11_TEX2D_UAV). + - Specifies the subresources in a 2D texture array that can be accessed (see D3D11_TEX2D_ARRAY_UAV). + + Specifies the subresources in a 2D texture array that can be accessed (see D3D11_TEX2D_ARRAY_UAV). + - Specifies subresources in a 3D texture that can be accessed (see D3D11_TEX3D_UAV). + + Specifies subresources in a 3D texture that can be accessed (see D3D11_TEX3D_UAV). + Get the properties of a buffer resource. - Microsoft Docs: - Pointer to a resource description (see D3D11_BUFFER_DESC) filled in by the method. + + Microsoft Docs: + + + Pointer to a resource description (see D3D11_BUFFER_DESC) filled in by the method. + A render-target-view interface identifies the render-target subresources that can be accessed during rendering. - Microsoft Docs: + + Microsoft Docs: + Specifies the subresources from a resource that are accessible using a render-target view. - Microsoft Docs: + + Microsoft Docs: + - The data format (see DXGI_FORMAT). + + The data format (see DXGI_FORMAT). + - The resource type (see D3D11_RTV_DIMENSION), which specifies how the render-target resource will be accessed. + + The resource type (see D3D11_RTV_DIMENSION), which specifies how the render-target resource will be accessed. + - Specifies which buffer elements can be accessed (see D3D11_BUFFER_RTV). + + Specifies which buffer elements can be accessed (see D3D11_BUFFER_RTV). + - Specifies the subresources in a 1D texture that can be accessed (see D3D11_TEX1D_RTV). + + Specifies the subresources in a 1D texture that can be accessed (see D3D11_TEX1D_RTV). + - Specifies the subresources in a 1D texture array that can be accessed (see D3D11_TEX1D_ARRAY_RTV). + + Specifies the subresources in a 1D texture array that can be accessed (see D3D11_TEX1D_ARRAY_RTV). + - Specifies the subresources in a 2D texture that can be accessed (see D3D11_TEX2D_RTV). + + Specifies the subresources in a 2D texture that can be accessed (see D3D11_TEX2D_RTV). + - Specifies the subresources in a 2D texture array that can be accessed (see D3D11_TEX2D_ARRAY_RTV). + + Specifies the subresources in a 2D texture array that can be accessed (see D3D11_TEX2D_ARRAY_RTV). + - Specifies a single subresource because a multisampled 2D texture only contains one subresource (see D3D11_TEX2DMS_RTV). + + Specifies a single subresource because a multisampled 2D texture only contains one subresource (see D3D11_TEX2DMS_RTV). + - Specifies the subresources in a multisampled 2D texture array that can be accessed (see D3D11_TEX2DMS_ARRAY_RTV). + + Specifies the subresources in a multisampled 2D texture array that can be accessed (see D3D11_TEX2DMS_ARRAY_RTV). + - Specifies subresources in a 3D texture that can be accessed (see D3D11_TEX3D_RTV). + + Specifies subresources in a 3D texture that can be accessed (see D3D11_TEX3D_RTV). + Specifies the subresources from an array of 1D textures to use in a depth-stencil view. - Microsoft Docs: + + Microsoft Docs: + @@ -2634,13 +3641,17 @@ For more information about this array size, see Remarks. Enter a device's critical section. - Microsoft Docs: + + Microsoft Docs: + Identifies whether conservative rasterization is on or off. - Microsoft Docs: + + Microsoft Docs: + @@ -2652,15 +3663,23 @@ For more information about this array size, see Remarks. Initializes a shader module from the function-linking-graph object. - Microsoft Docs: - The address of a pointer to an ID3D11ModuleInstance interface for the shader module to initialize. - An optional pointer to a variable that receives a pointer to the ID3DBlob interface that you can use to access compiler error messages, or NULL if there are no errors. + + Microsoft Docs: + + + The address of a pointer to an ID3D11ModuleInstance interface for the shader module to initialize. + + + An optional pointer to a variable that receives a pointer to the ID3DBlob interface that you can use to access compiler error messages, or NULL if there are no errors. + Indicates triangles facing a particular direction are not drawn. - Microsoft Docs: + + Microsoft Docs: + @@ -2675,11 +3694,15 @@ For more information about this array size, see Remarks. Specifies statistics about a trace. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_SHADER_TRACE_DESC structure that describes the shader trace object for which this structure specifies statistics. + + A D3D11_SHADER_TRACE_DESC structure that describes the shader trace object for which this structure specifies statistics. + The number of calls in the stamp for the trace. This value is always 1 for vertex shaders, hull shaders, domain shaders, geometry shaders, and compute shaders. This value is 4 for pixel shaders. @@ -2691,16 +3714,20 @@ For more information about this array size, see Remarks. The total number of steps for the trace. This number is the same for all stamp calls. - The component trace mask for each input v# register. For information about D3D11_TRACE_COMPONENT_MASK, see D3D11_TRACE_VALUE. + + The component trace mask for each input v# register. For information about D3D11_TRACE_COMPONENT_MASK, see D3D11_TRACE_VALUE. -For vertex shaders, geometry shaders, pixel shaders, hull shaders, and domain shaders, the valid range is [0..31]. For compute shaders, this member is not applicable. Also, inputs for geometry shaders are 2D-indexed. For example, consider v[vertex][attribute]. In this example, the range of [attribute] is [0..31]. The [vertex] axis is the same size for all inputs, which are determined by the GSInputPrimitive member. + For vertex shaders, geometry shaders, pixel shaders, hull shaders, and domain shaders, the valid range is [0..31]. For compute shaders, this member is not applicable. Also, inputs for geometry shaders are 2D-indexed. For example, consider v[vertex][attribute]. In this example, the range of [attribute] is [0..31]. The [vertex] axis is the same size for all inputs, which are determined by the GSInputPrimitive member. -Similarly, inputs for hull shader and domain shader are 2D-indexed. For example, consider v[vertex][attribute]. In this example, the range of [attribute] is [0..15]. The [vertex] axis is the same size for all inputs. + Similarly, inputs for hull shader and domain shader are 2D-indexed. For example, consider v[vertex][attribute]. In this example, the range of [attribute] is [0..15]. The [vertex] axis is the same size for all inputs. + - The component trace mask for each output o# register. For information about D3D11_TRACE_COMPONENT_MASK, see D3D11_TRACE_VALUE. + + The component trace mask for each output o# register. For information about D3D11_TRACE_COMPONENT_MASK, see D3D11_TRACE_VALUE. -For vertex shaders and geometry shaders, the valid range is [0..31]. For pixel shaders, the valid range is [0..7]. For compute shaders, this member is not applicable. For output control points for hull shaders, the registers are 2D-indexed. For example, consider ocp[vertex][attribute]. In this example, the range of [attribute] is [0..31]. The [vertex] axis is the same size for all inputs. + For vertex shaders and geometry shaders, the valid range is [0..31]. For pixel shaders, the valid range is [0..7]. For compute shaders, this member is not applicable. For output control points for hull shaders, the registers are 2D-indexed. For example, consider ocp[vertex][attribute]. In this example, the range of [attribute] is [0..31]. The [vertex] axis is the same size for all inputs. + The number of temps, that is, 4x32 bit r# registers that are declared. @@ -2709,40 +3736,66 @@ For vertex shaders and geometry shaders, the valid range is [0..31]. For pixel s The maximum index #+1 of all indexable temps x#[] that are declared. If they are declared sparsely (for example, x3[12] and x200[30] only), this value is 201 (200+1). - The number of temps for each indexable temp x#[numTemps]. You can only have temps up to the value in the MaxIndexableTempIndex member. + + The number of temps for each indexable temp x#[numTemps]. You can only have temps up to the value in the MaxIndexableTempIndex member. + The number of 4x32 bit values (if any) that are in the immediate constant buffer. -
Note  This member is for pixel shaders only, [stampIndex].
-
 
-A mask that indicates which MSAA samples are covered for each stamp. This coverage occurs before alpha-to-coverage, depth, and stencil operations are performed on the pixel. For non-MSAA, examine the least significant bit (LSB). This mask can be 0 for pixels that are only executed to support derivatives for neighboring pixels. + +
+ Note  This member is for pixel shaders only, [stampIndex]. +
+
 
+ A mask that indicates which MSAA samples are covered for each stamp. This coverage occurs before alpha-to-coverage, depth, and stencil operations are performed on the pixel. For non-MSAA, examine the least significant bit (LSB). This mask can be 0 for pixels that are only executed to support derivatives for neighboring pixels. + -
Note  This member is for pixel shaders only, [stampIndex].
-
 
-A mask that indicates discarded samples. If the pixel shader runs at pixel-frequency, "discard" turns off all the samples. If all the samples are off, the following four mask members are also 0. + +
+ Note  This member is for pixel shaders only, [stampIndex]. +
+
 
+ A mask that indicates discarded samples. If the pixel shader runs at pixel-frequency, "discard" turns off all the samples. If all the samples are off, the following four mask members are also 0. + -
Note  This member is for pixel shaders only, [stampIndex].
-
 
-A mask that indicates the MSAA samples that are covered. For non-MSAA, examine the LSB. + +
+ Note  This member is for pixel shaders only, [stampIndex]. +
+
 
+ A mask that indicates the MSAA samples that are covered. For non-MSAA, examine the LSB. + -
Note  This member is for pixel shaders only, [stampIndex].
-
 
-A mask that indicates the MSAA samples that are covered after alpha-to-coverage+sampleMask, but before depth and stencil. For non-MSAA, examine the LSB. + +
+ Note  This member is for pixel shaders only, [stampIndex]. +
+
 
+ A mask that indicates the MSAA samples that are covered after alpha-to-coverage+sampleMask, but before depth and stencil. For non-MSAA, examine the LSB. + -
Note  This member is for pixel shaders only, [stampIndex].
-
 
-A mask that indicates the MSAA samples that are covered after alpha-to-coverage+sampleMask+depth, but before stencil. For non-MSAA, examine the LSB. + +
+ Note  This member is for pixel shaders only, [stampIndex]. +
+
 
+ A mask that indicates the MSAA samples that are covered after alpha-to-coverage+sampleMask+depth, but before stencil. For non-MSAA, examine the LSB. + -
Note  This member is for pixel shaders only, [stampIndex].
-
 
-A mask that indicates the MSAA samples that are covered after alpha-to-coverage+sampleMask+depth+stencil. For non-MSAA, examine the LSB. + +
+ Note  This member is for pixel shaders only, [stampIndex]. +
+
 
+ A mask that indicates the MSAA samples that are covered after alpha-to-coverage+sampleMask+depth+stencil. For non-MSAA, examine the LSB. + A value that specifies whether this trace is for a pixel shader that outputs the oDepth register. TRUE indicates that the pixel shader outputs the oDepth register; otherwise, FALSE. @@ -2751,116 +3804,178 @@ A mask that indicates the MSAA samples that are covered after alpha-to-coverage+ A value that specifies whether this trace is for a pixel shader that outputs the oMask register. TRUE indicates that the pixel shader outputs the oMask register; otherwise, FALSE. - A D3D11_TRACE_GS_INPUT_PRIMITIVE-typed value that identifies the type of geometry shader input primitive. That is, this value identifies: {point, line, triangle, line_adj, triangle_adj} or the number of vertices: 1, 2, 3, 4, or 6 respectively. For example, for a line, input v[][#] is actually v[2][#]. For vertex shaders and pixel shaders, set this member to D3D11_TRACE_GS_INPUT_PRIMITIVE_UNDEFINED. + + A D3D11_TRACE_GS_INPUT_PRIMITIVE-typed value that identifies the type of geometry shader input primitive. That is, this value identifies: {point, line, triangle, line_adj, triangle_adj} or the number of vertices: 1, 2, 3, 4, or 6 respectively. For example, for a line, input v[][#] is actually v[2][#]. For vertex shaders and pixel shaders, set this member to D3D11_TRACE_GS_INPUT_PRIMITIVE_UNDEFINED. + A value that specifies whether this trace is for a geometry shader that inputs the PrimitiveID register. TRUE indicates that the geometry shader inputs the PrimitiveID register; otherwise, FALSE. -
Note  This member is for hull shaders only.
-
 
-The component trace mask for the hull-shader output. For information about D3D11_TRACE_COMPONENT_MASK, see D3D11_TRACE_VALUE. + +
+ Note  This member is for hull shaders only. +
+
 
+ The component trace mask for the hull-shader output. For information about D3D11_TRACE_COMPONENT_MASK, see D3D11_TRACE_VALUE. -The D3D11_TRACE_INPUT_PRIMITIVE_ID_REGISTER value is available through a call to the ID3D11ShaderTrace::GetInitialRegisterContents method. + The D3D11_TRACE_INPUT_PRIMITIVE_ID_REGISTER value is available through a call to the ID3D11ShaderTrace::GetInitialRegisterContents method. + -
Note  This member is for domain shaders only.
-
 
-The component trace mask for the domain-shader input. For information about D3D11_TRACE_COMPONENT_MASK, see D3D11_TRACE_VALUE. + +
+ Note  This member is for domain shaders only. +
+
 
+ The component trace mask for the domain-shader input. For information about D3D11_TRACE_COMPONENT_MASK, see D3D11_TRACE_VALUE. -The following values are available through a call to the ID3D11ShaderTrace::GetInitialRegisterContents method: + The following values are available through a call to the ID3D11ShaderTrace::GetInitialRegisterContents method: - + + Gets an immediate context, which can play back command lists. - Microsoft Docs: - Upon completion of the method, the passed pointer to an ID3D11DeviceContext interface pointer is initialized. + + Microsoft Docs: + + + Upon completion of the method, the passed pointer to an ID3D11DeviceContext interface pointer is initialized. + Query types. - Microsoft Docs: + + Microsoft Docs: + - Determines whether or not the GPU is finished processing commands. When the GPU is finished processing commands ID3D11DeviceContext::GetData will return S_OK, and pData will point to a BOOL with a value of TRUE. When using this type of query, ID3D11DeviceContext::Begin is disabled. + + Determines whether or not the GPU is finished processing commands. When the GPU is finished processing commands ID3D11DeviceContext::GetData will return S_OK, and pData will point to a BOOL with a value of TRUE. When using this type of query, ID3D11DeviceContext::Begin is disabled. + - Get the number of samples that passed the depth and stencil tests in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a UINT64. If a depth or stencil test is disabled, then each of those tests will be counted as a pass. + + Get the number of samples that passed the depth and stencil tests in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a UINT64. If a depth or stencil test is disabled, then each of those tests will be counted as a pass. + - Get a timestamp value where ID3D11DeviceContext::GetData returns a UINT64. This kind of query is only useful if two timestamp queries are done in the middle of a D3D11_QUERY_TIMESTAMP_DISJOINT query. The difference of two timestamps can be used to determine how many ticks have elapsed, and the D3D11_QUERY_TIMESTAMP_DISJOINT query will determine if that difference is a reliable value and also has a value that shows how to convert the number of ticks into seconds. See D3D11_QUERY_DATA_TIMESTAMP_DISJOINT. When using this type of query, ID3D11DeviceContext::Begin is disabled. + + Get a timestamp value where ID3D11DeviceContext::GetData returns a UINT64. This kind of query is only useful if two timestamp queries are done in the middle of a D3D11_QUERY_TIMESTAMP_DISJOINT query. The difference of two timestamps can be used to determine how many ticks have elapsed, and the D3D11_QUERY_TIMESTAMP_DISJOINT query will determine if that difference is a reliable value and also has a value that shows how to convert the number of ticks into seconds. See D3D11_QUERY_DATA_TIMESTAMP_DISJOINT. When using this type of query, ID3D11DeviceContext::Begin is disabled. + - Determines whether or not a D3D11_QUERY_TIMESTAMP is returning reliable values, and also gives the frequency of the processor enabling you to convert the number of elapsed ticks into seconds. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_TIMESTAMP_DISJOINT. This type of query should only be invoked once per frame or less. + + Determines whether or not a D3D11_QUERY_TIMESTAMP is returning reliable values, and also gives the frequency of the processor enabling you to convert the number of elapsed ticks into seconds. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_TIMESTAMP_DISJOINT. This type of query should only be invoked once per frame or less. + - Get pipeline statistics, such as the number of pixel shader invocations in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_PIPELINE_STATISTICS. + + Get pipeline statistics, such as the number of pixel shader invocations in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_PIPELINE_STATISTICS. + - Similar to D3D11_QUERY_OCCLUSION, except ID3D11DeviceContext::GetData returns a BOOL indicating whether or not any samples passed the depth and stencil tests - TRUE meaning at least one passed, FALSE meaning none passed. + + Similar to D3D11_QUERY_OCCLUSION, except ID3D11DeviceContext::GetData returns a BOOL indicating whether or not any samples passed the depth and stencil tests - TRUE meaning at least one passed, FALSE meaning none passed. + - Get streaming output statistics, such as the number of primitives streamed out in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_SO_STATISTICS structure. + + Get streaming output statistics, such as the number of primitives streamed out in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_SO_STATISTICS structure. + - Determines whether or not any of the streaming output buffers overflowed in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a BOOL - TRUE meaning there was an overflow, FALSE meaning there was not an overflow. If streaming output writes to multiple buffers, and one of the buffers overflows, then it will stop writing to all the output buffers. When an overflow is detected by Direct3D it is prevented from happening - no memory is corrupted. This predication may be used in conjunction with an SO_STATISTICS query so that when an overflow occurs the SO_STATISTIC query will let the application know how much memory was needed to prevent an overflow. + + Determines whether or not any of the streaming output buffers overflowed in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a BOOL - TRUE meaning there was an overflow, FALSE meaning there was not an overflow. If streaming output writes to multiple buffers, and one of the buffers overflows, then it will stop writing to all the output buffers. When an overflow is detected by Direct3D it is prevented from happening - no memory is corrupted. This predication may be used in conjunction with an SO_STATISTICS query so that when an overflow occurs the SO_STATISTIC query will let the application know how much memory was needed to prevent an overflow. + - Get streaming output statistics for stream 0, such as the number of primitives streamed out in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_SO_STATISTICS structure. + + Get streaming output statistics for stream 0, such as the number of primitives streamed out in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_SO_STATISTICS structure. + - Determines whether or not the stream 0 output buffers overflowed in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a BOOL - TRUE meaning there was an overflow, FALSE meaning there was not an overflow. If streaming output writes to multiple buffers, and one of the buffers overflows, then it will stop writing to all the output buffers. When an overflow is detected by Direct3D it is prevented from happening - no memory is corrupted. This predication may be used in conjunction with an SO_STATISTICS query so that when an overflow occurs the SO_STATISTIC query will let the application know how much memory was needed to prevent an overflow. + + Determines whether or not the stream 0 output buffers overflowed in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a BOOL - TRUE meaning there was an overflow, FALSE meaning there was not an overflow. If streaming output writes to multiple buffers, and one of the buffers overflows, then it will stop writing to all the output buffers. When an overflow is detected by Direct3D it is prevented from happening - no memory is corrupted. This predication may be used in conjunction with an SO_STATISTICS query so that when an overflow occurs the SO_STATISTIC query will let the application know how much memory was needed to prevent an overflow. + - Get streaming output statistics for stream 1, such as the number of primitives streamed out in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_SO_STATISTICS structure. + + Get streaming output statistics for stream 1, such as the number of primitives streamed out in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_SO_STATISTICS structure. + - Determines whether or not the stream 1 output buffers overflowed in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a BOOL - TRUE meaning there was an overflow, FALSE meaning there was not an overflow. If streaming output writes to multiple buffers, and one of the buffers overflows, then it will stop writing to all the output buffers. When an overflow is detected by Direct3D it is prevented from happening - no memory is corrupted. This predication may be used in conjunction with an SO_STATISTICS query so that when an overflow occurs the SO_STATISTIC query will let the application know how much memory was needed to prevent an overflow. + + Determines whether or not the stream 1 output buffers overflowed in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a BOOL - TRUE meaning there was an overflow, FALSE meaning there was not an overflow. If streaming output writes to multiple buffers, and one of the buffers overflows, then it will stop writing to all the output buffers. When an overflow is detected by Direct3D it is prevented from happening - no memory is corrupted. This predication may be used in conjunction with an SO_STATISTICS query so that when an overflow occurs the SO_STATISTIC query will let the application know how much memory was needed to prevent an overflow. + - Get streaming output statistics for stream 2, such as the number of primitives streamed out in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_SO_STATISTICS structure. + + Get streaming output statistics for stream 2, such as the number of primitives streamed out in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_SO_STATISTICS structure. + - Determines whether or not the stream 2 output buffers overflowed in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a BOOL - TRUE meaning there was an overflow, FALSE meaning there was not an overflow. If streaming output writes to multiple buffers, and one of the buffers overflows, then it will stop writing to all the output buffers. When an overflow is detected by Direct3D it is prevented from happening - no memory is corrupted. This predication may be used in conjunction with an SO_STATISTICS query so that when an overflow occurs the SO_STATISTIC query will let the application know how much memory was needed to prevent an overflow. + + Determines whether or not the stream 2 output buffers overflowed in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a BOOL - TRUE meaning there was an overflow, FALSE meaning there was not an overflow. If streaming output writes to multiple buffers, and one of the buffers overflows, then it will stop writing to all the output buffers. When an overflow is detected by Direct3D it is prevented from happening - no memory is corrupted. This predication may be used in conjunction with an SO_STATISTICS query so that when an overflow occurs the SO_STATISTIC query will let the application know how much memory was needed to prevent an overflow. + - Get streaming output statistics for stream 3, such as the number of primitives streamed out in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_SO_STATISTICS structure. + + Get streaming output statistics for stream 3, such as the number of primitives streamed out in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData will return a D3D11_QUERY_DATA_SO_STATISTICS structure. + - Determines whether or not the stream 3 output buffers overflowed in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a BOOL - TRUE meaning there was an overflow, FALSE meaning there was not an overflow. If streaming output writes to multiple buffers, and one of the buffers overflows, then it will stop writing to all the output buffers. When an overflow is detected by Direct3D it is prevented from happening - no memory is corrupted. This predication may be used in conjunction with an SO_STATISTICS query so that when an overflow occurs the SO_STATISTIC query will let the application know how much memory was needed to prevent an overflow. + + Determines whether or not the stream 3 output buffers overflowed in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. ID3D11DeviceContext::GetData returns a BOOL - TRUE meaning there was an overflow, FALSE meaning there was not an overflow. If streaming output writes to multiple buffers, and one of the buffers overflows, then it will stop writing to all the output buffers. When an overflow is detected by Direct3D it is prevented from happening - no memory is corrupted. This predication may be used in conjunction with an SO_STATISTICS query so that when an overflow occurs the SO_STATISTIC query will let the application know how much memory was needed to prevent an overflow. + Describes whether a GPU profiling technique is supported. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether the hardware and driver support a GPU profiling technique that can be used with development tools. The runtime sets this member to TRUE if the hardware and driver support data marking. + + Specifies whether the hardware and driver support a GPU profiling technique that can be used with development tools. The runtime sets this member to TRUE if the hardware and driver support data marking. + This interface encapsulates an HLSL class. - Microsoft Docs: + + Microsoft Docs: + The device interface represents a virtual adapter; it is used to create resources. - Microsoft Docs: + + Microsoft Docs: + Calculates a subresource index for a texture. - Microsoft Docs: + + Microsoft Docs: + A zero-based index for the mipmap level to address; 0 indicates the first, most detailed mipmap level. The zero-based index for the array level to address; always use 0 for volume (3D) textures. Number of mipmap levels in the resource. @@ -2869,17 +3984,29 @@ The following values are available through a call to the Retrieves information about a register that was written by a step in the trace. - Microsoft Docs: - The index of the step within the trace. The range of the index is [0...NumTraceSteps-1], where NumTraceSteps is a member of the D3D11_TRACE_STATS structure. You can retrieve information in any step order. - The index of the register within the trace step. The range of the index is [0...NumRegistersWritten-1], where NumRegistersWritten is a member of the D3D11_TRACE_STEP structure. - A pointer to a D3D11_TRACE_REGISTER structure. GetWrittenRegister fills the members of this structure with information about the register that was written by the step in the trace. - A pointer to a D3D11_TRACE_VALUE structure. GetWrittenRegister fills the members of this structure with information about the value that was written to the register. + + Microsoft Docs: + + + The index of the step within the trace. The range of the index is [0...NumTraceSteps-1], where NumTraceSteps is a member of the D3D11_TRACE_STATS structure. You can retrieve information in any step order. + + + The index of the register within the trace step. The range of the index is [0...NumRegistersWritten-1], where NumRegistersWritten is a member of the D3D11_TRACE_STEP structure. + + + A pointer to a D3D11_TRACE_REGISTER structure. GetWrittenRegister fills the members of this structure with information about the register that was written by the step in the trace. + + + A pointer to a D3D11_TRACE_VALUE structure. GetWrittenRegister fills the members of this structure with information about the value that was written to the register. + Describes a shader. - Microsoft Docs: + + Microsoft Docs: + @@ -2961,13 +4088,17 @@ The following values are available through a call to the - The D3D_PRIMITIVE_TOPOLOGY-typed value that represents the geometry shader output topology. + + The D3D_PRIMITIVE_TOPOLOGY-typed value that represents the geometry shader output topology. + Geometry shader maximum output vertex count. - The D3D_PRIMITIVE-typed value that represents the input primitive for a geometry shader or hull shader. + + The D3D_PRIMITIVE-typed value that represents the input primitive for a geometry shader or hull shader. + Number of parameters in the patch-constant signature. @@ -2979,13 +4110,19 @@ The following values are available through a call to the - The D3D_TESSELLATOR_OUTPUT_PRIMITIVE-typed value that represents the tessellator output-primitive type. + + The D3D_TESSELLATOR_OUTPUT_PRIMITIVE-typed value that represents the tessellator output-primitive type. + - The D3D_TESSELLATOR_PARTITIONING-typed value that represents the tessellator partitioning mode. + + The D3D_TESSELLATOR_PARTITIONING-typed value that represents the tessellator partitioning mode. + - The D3D_TESSELLATOR_DOMAIN-typed value that represents the tessellator domain. + + The D3D_TESSELLATOR_DOMAIN-typed value that represents the tessellator domain. + Number of barrier instructions in a compute shader. @@ -2999,14 +4136,20 @@ The following values are available through a call to the Signals the end of a decoding operation. - Microsoft Docs: - A pointer to the ID3D11VideoDecoder interface. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoder. + + Microsoft Docs: + + + A pointer to the ID3D11VideoDecoder interface. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoder. + Specifies texture layout options. - Microsoft Docs: + + Microsoft Docs: + @@ -3021,88 +4164,132 @@ The following values are available through a call to the Bind an input-layout object to the input-assembler stage. - Microsoft Docs: - A pointer to the input-layout object (see ID3D11InputLayout), which describes the input buffers that will be read by the IA stage. + + Microsoft Docs: + + + A pointer to the input-layout object (see ID3D11InputLayout), which describes the input buffers that will be read by the IA stage. + Describes a video processor output view. - Microsoft Docs: + + Microsoft Docs: + - The resource type of the view, specified as a member of the D3D11_VPOV_DIMENSION enumeration. + + The resource type of the view, specified as a member of the D3D11_VPOV_DIMENSION enumeration. + - A D3D11_TEX2D_VPOV structure that identifies the texture resource for the output view. + + A D3D11_TEX2D_VPOV structure that identifies the texture resource for the output view. -Use this member of the union when ViewDimension equals D3D11_VPOV_DIMENSION_TEXTURE2D. + Use this member of the union when ViewDimension equals D3D11_VPOV_DIMENSION_TEXTURE2D. + - A D3D11_TEX2D_ARRAY_VPOV structure that identifies the texture array for the output view. + + A D3D11_TEX2D_ARRAY_VPOV structure that identifies the texture array for the output view. -Use this member of the union when ViewDimension equals D3D11_VPOV_DIMENSION_TEXTURE2DARRAY. + Use this member of the union when ViewDimension equals D3D11_VPOV_DIMENSION_TEXTURE2DARRAY. + Represents a hardware-accelerated video decoder for Microsoft Direct3D 11. - Microsoft Docs: + + Microsoft Docs: + Specifies how the CPU should respond when an application calls the ID3D11DeviceContext::Map method on a resource that is being used by the GPU. - Microsoft Docs: + + Microsoft Docs: + - Specifies that ID3D11DeviceContext::Map should return DXGI_ERROR_WAS_STILL_DRAWING when the GPU blocks the CPU from accessing a resource. For more information about this error code, see DXGI_ERROR. + + Specifies that ID3D11DeviceContext::Map should return DXGI_ERROR_WAS_STILL_DRAWING when the GPU blocks the CPU from accessing a resource. For more information about this error code, see DXGI_ERROR. + Gets the color space information for the video processor output surface. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. - A pointer to a DXGI_COLOR_SPACE_TYPE value that indicates the colorspace for the video processor output surface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + + + A pointer to a DXGI_COLOR_SPACE_TYPE value that indicates the colorspace for the video processor output surface. + The rasterizer-state interface holds a description for rasterizer state that you can bind to the rasterizer stage. This rasterizer-state interface supports forced sample count and conservative rasterization mode. - Microsoft Docs: + + Microsoft Docs: + Bind an array of shader resources to the vertex-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting shader resources to (range is from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). Number of shader resources to set. Up to a maximum of 128 slots are available for shader resources (range is from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to set to the device. + + Array of shader resource view interfaces to set to the device. + Gets a constant buffer by name for a function. - Microsoft Docs: + + Microsoft Docs: + The constant-buffer name. Specifies whether an input stream on the video processor contains interlaced or progressive frames. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - A D3D11_VIDEO_FRAME_FORMAT value that specifies the interlacing. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + A D3D11_VIDEO_FRAME_FORMAT value that specifies the interlacing. + Gets values that indicate whether the video processor input stream is being flipped vertically or horizontally. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + An index identifying the input stream. A pointer to a boolean value indicating whether mirroring is enabled. True if mirroring is enabled; otherwise, false. A pointer to a boolean value indicating whether the stream is being flipped horizontally. True if the stream is being flipped horizontally; otherwise, false. @@ -3112,56 +4299,80 @@ Use this member of the union when ViewDimension equals D3D11_VPOV_DIME Adds an instance of a library module to be used for linking. - Microsoft Docs: - A pointer to the ID3D11ModuleInstance interface for the library module instance. + + Microsoft Docs: + + + A pointer to the ID3D11ModuleInstance interface for the library module instance. + Get the exception-mode flags. - Microsoft Docs: + + Microsoft Docs: + Gets the type of the current HLSL class. - Microsoft Docs: + + Microsoft Docs: + Type of the current HLSL class. - The length of the pTypeName parameter. + + The length of the pTypeName parameter. + Specifies a Direct3D 11 video feature or feature set to query about. - Microsoft Docs: + + Microsoft Docs: + - Retrieves the supported components, bin count, and counter bit depth for the a decode histogram with the specified decode profile, resolution, and format. The associated data structure is D3D11_FEATURE_DATA_VIDEO_DECODER_HISTOGRAM. + + Retrieves the supported components, bin count, and counter bit depth for the a decode histogram with the specified decode profile, resolution, and format. The associated data structure is D3D11_FEATURE_DATA_VIDEO_DECODER_HISTOGRAM. + The device context interface represents a device context; it is used to render commands. ID3D11DeviceContext4 adds new methods to those in ID3D11DeviceContext3. - Microsoft Docs: + + Microsoft Docs: + Provides the video functionality of a Microsoft Direct3D 11 device. - Microsoft Docs: + + Microsoft Docs: + Get the resource that is accessed through this view. - Microsoft Docs: - Address of a pointer to the resource that is accessed through this view. (See ID3D11Resource.) + + Microsoft Docs: + + + Address of a pointer to the resource that is accessed through this view. (See ID3D11Resource.) + Sets private data on the video device and associates that data with a GUID. - Microsoft Docs: + + Microsoft Docs: + The GUID associated with the data. The size of the data, in bytes. A pointer to the data. @@ -3170,7 +4381,9 @@ Use this member of the union when ViewDimension equals D3D11_VPOV_DIME Specifies the subresources from an array of multisampled 2D textures to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + @@ -3182,7 +4395,9 @@ Use this member of the union when ViewDimension equals D3D11_VPOV_DIME Optional flags that control the behavior of ID3D11DeviceContext::GetData. - Microsoft Docs: + + Microsoft Docs: + @@ -3191,26 +4406,42 @@ Use this member of the union when ViewDimension equals D3D11_VPOV_DIME Reads encrypted data from a protected surface. - Microsoft Docs: - A pointer to the ID3D11CryptoSession interface of the cryptographic session. - A pointer to the ID3D11Texture2D interface of the protected surface. - A pointer to the ID3D11Texture2D interface of the surface that receives the encrypted data. - The size of the pIV buffer, in bytes. - A pointer to a buffer that receives the initialization vector (IV). The caller allocates this buffer, but the driver generates the IV. + + Microsoft Docs: + + + A pointer to the ID3D11CryptoSession interface of the cryptographic session. + + + A pointer to the ID3D11Texture2D interface of the protected surface. + + + A pointer to the ID3D11Texture2D interface of the surface that receives the encrypted data. + + + The size of the pIV buffer, in bytes. + + + A pointer to a buffer that receives the initialization vector (IV). The caller allocates this buffer, but the driver generates the IV. -For 128-bit AES-CTR encryption, pIV points to a D3D11_AES_CTR_IV structure. When the driver generates the first IV, it initializes the structure to a random number. For each subsequent IV, the driver simply increments the IV member of the structure, ensuring that the value always increases. The application can validate that the same IV is never used more than once with the same key pair. + For 128-bit AES-CTR encryption, pIV points to a D3D11_AES_CTR_IV structure. When the driver generates the first IV, it initializes the structure to a random number. For each subsequent IV, the driver simply increments the IV member of the structure, ensuring that the value always increases. The application can validate that the same IV is never used more than once with the same key pair. + Gets the number of bitwise instructions. - Microsoft Docs: + + Microsoft Docs: + Indicates which resource types to track. - Microsoft Docs: + + Microsoft Docs: + @@ -3240,35 +4471,59 @@ For 128-bit AES-CTR encryption, pIV points to a Gets the description for sampler state that you used to create the sampler-state object. - Microsoft Docs: - A pointer to a D3D11_SAMPLER_DESC structure that receives a description of the sampler state. + + Microsoft Docs: + + + A pointer to a D3D11_SAMPLER_DESC structure that receives a description of the sampler state. + Get data from the graphics processing unit (GPU) asynchronously. - Microsoft Docs: - A pointer to an ID3D11Asynchronous interface for the object about which GetData retrieves data. - Address of memory that will receive the data. If NULL, GetData will be used only to check status. The type of data output depends on the type of asynchronous interface. - Size of the data to retrieve or 0. Must be 0 when pData is NULL. - Optional flags. Can be 0 or any combination of the flags enumerated by D3D11_ASYNC_GETDATA_FLAG. + + Microsoft Docs: + + + A pointer to an ID3D11Asynchronous interface for the object about which GetData retrieves data. + + + Address of memory that will receive the data. If NULL, GetData will be used only to check status. The type of data output depends on the type of asynchronous interface. + + + Size of the data to retrieve or 0. Must be 0 when pData is NULL. + + + Optional flags. Can be 0 or any combination of the flags enumerated by D3D11_ASYNC_GETDATA_FLAG. + Bind one or more render targets atomically and the depth-stencil buffer to the output-merger stage. - Microsoft Docs: - Number of render targets to bind (ranges between 0 and D3D11_SIMULTANEOUS_RENDER_TARGET_COUNT). If this parameter is nonzero, the number of entries in the array to which ppRenderTargetViews points must equal the number in this parameter. - Pointer to an array of ID3D11RenderTargetView that represent the render targets to bind to the device. - If this parameter is NULL and NumViews is 0, no render targets are bound. - Pointer to a ID3D11DepthStencilView that represents the depth-stencil view to bind to the device. - If this parameter is NULL, the depth-stencil view is not bound. + + Microsoft Docs: + + + Number of render targets to bind (ranges between 0 and D3D11_SIMULTANEOUS_RENDER_TARGET_COUNT). If this parameter is nonzero, the number of entries in the array to which ppRenderTargetViews points must equal the number in this parameter. + + + Pointer to an array of ID3D11RenderTargetView that represent the render targets to bind to the device. + If this parameter is NULL and NumViews is 0, no render targets are bound. + + + Pointer to a ID3D11DepthStencilView that represents the depth-stencil view to bind to the device. + If this parameter is NULL, the depth-stencil view is not bound. + Identify which components of each pixel of a render target are writable during blending. - Microsoft Docs: + + Microsoft Docs: + @@ -3289,50 +4544,74 @@ For 128-bit AES-CTR encryption, pIV points to a Generates mipmaps for the given shader resource. - Microsoft Docs: - A pointer to an ID3D11ShaderResourceView interface that represents the shader resource. + + Microsoft Docs: + + + A pointer to an ID3D11ShaderResourceView interface that represents the shader resource. + Creates a fence object. - Microsoft Docs: + + Microsoft Docs: + The initial value for the fence. - A combination of D3D11_FENCE_FLAG-typed values that are combined by using a bitwise OR operation. - The resulting value specifies options for the fence. - The globally unique identifier (GUID) for the fence interface (ID3D11Fence). - The REFIID, or GUID, of the interface to the fence can be obtained by using the __uuidof() macro. - For example, __uuidof(ID3D11Fence) will get the GUID of the interface to a fence. - A pointer to a memory block that receives a pointer to the ID3D11Fence interface that is used to access the fence. + + A combination of D3D11_FENCE_FLAG-typed values that are combined by using a bitwise OR operation. + The resulting value specifies options for the fence. + + + The globally unique identifier (GUID) for the fence interface (ID3D11Fence). + The REFIID, or GUID, of the interface to the fence can be obtained by using the __uuidof() macro. + For example, __uuidof(ID3D11Fence) will get the GUID of the interface to a fence. + + + A pointer to a memory block that receives a pointer to the ID3D11Fence interface that is used to access the fence. + Registers the "device removed" event and indicates when a Direct3D device has become removed for any reason, using an asynchronous notification mechanism. - Microsoft Docs: + + Microsoft Docs: + The handle to the "device removed" event. - A pointer to information about the "device removed" event, which can be used in UnregisterDeviceRemoved to unregister the event. + + A pointer to information about the "device removed" event, which can be used in UnregisterDeviceRemoved to unregister the event. + Bind an array of scissor rectangles to the rasterizer stage. - Microsoft Docs: + + Microsoft Docs: + Number of scissor rectangles to bind. - An array of scissor rectangles (see D3D11_RECT). + + An array of scissor rectangles (see D3D11_RECT). + Specifies which bytes in a video surface are encrypted. - Microsoft Docs: + + Microsoft Docs: + The number of bytes that are encrypted at the start of the buffer. - The number of bytes that are skipped after the first NumEncryptedBytesAtBeginning bytes, and then after each block of NumBytesInEncryptPattern bytes. Skipped bytes are not encrypted. + + The number of bytes that are skipped after the first NumEncryptedBytesAtBeginning bytes, and then after each block of NumBytesInEncryptPattern bytes. Skipped bytes are not encrypted. + The number of bytes that are encrypted after each block of skipped bytes. @@ -3340,47 +4619,71 @@ For 128-bit AES-CTR encryption, pIV points to a Describes a 1D texture. - Microsoft Docs: + + Microsoft Docs: + - Texture width (in texels). The range is from 1 to D3D11_REQ_TEXTURE1D_U_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Texture width (in texels). The range is from 1 to D3D11_REQ_TEXTURE1D_U_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - The maximum number of mipmap levels in the texture. See the remarks in D3D11_TEX1D_SRV. Use 1 for a multisampled texture; or 0 to generate a full set of subtextures. + + The maximum number of mipmap levels in the texture. See the remarks in D3D11_TEX1D_SRV. Use 1 for a multisampled texture; or 0 to generate a full set of subtextures. + - Number of textures in the array. The range is from 1 to D3D11_REQ_TEXTURE1D_ARRAY_AXIS_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Number of textures in the array. The range is from 1 to D3D11_REQ_TEXTURE1D_ARRAY_AXIS_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - Texture format (see DXGI_FORMAT). + + Texture format (see DXGI_FORMAT). + - Value that identifies how the texture is to be read from and written to. The most common value is D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + + Value that identifies how the texture is to be read from and written to. The most common value is D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + - Flags (see D3D11_BIND_FLAG) for binding to pipeline stages. The flags can be combined by a logical OR. For a 1D texture, the allowable values are: D3D11_BIND_SHADER_RESOURCE, D3D11_BIND_RENDER_TARGET and D3D11_BIND_DEPTH_STENCIL. + + Flags (see D3D11_BIND_FLAG) for binding to pipeline stages. The flags can be combined by a logical OR. For a 1D texture, the allowable values are: D3D11_BIND_SHADER_RESOURCE, D3D11_BIND_RENDER_TARGET and D3D11_BIND_DEPTH_STENCIL. + - Flags (see D3D11_CPU_ACCESS_FLAG) to specify the types of CPU access allowed. Use 0 if CPU access is not required. These flags can be combined with a logical OR. + + Flags (see D3D11_CPU_ACCESS_FLAG) to specify the types of CPU access allowed. Use 0 if CPU access is not required. These flags can be combined with a logical OR. + - Flags (see D3D11_RESOURCE_MISC_FLAG) that identify other, less common resource options. Use 0 if none of these flags apply. These flags can be combined with a logical OR. + + Flags (see D3D11_RESOURCE_MISC_FLAG) that identify other, less common resource options. Use 0 if none of these flags apply. These flags can be combined with a logical OR. + Enables better interoperability with a component that might be handed a Direct3D 11 device, but which wants to leverage Direct3D 12 instead. - Microsoft Docs: + + Microsoft Docs: + Contains the response to a D3D11_AUTHENTICATED_QUERY_ENCRYPTION_WHEN_ACCESSIBLE_GUID_COUNT query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + The number of encryption GUIDs. @@ -3388,203 +4691,284 @@ For 128-bit AES-CTR encryption, pIV points to a Allow or deny certain types of messages to pass through a filter. - Microsoft Docs: + + Microsoft Docs: + Number of message categories to allow or deny. - Array of message categories to allow or deny. Array must have at least NumCategories members (see D3D11_MESSAGE_CATEGORY). + + Array of message categories to allow or deny. Array must have at least NumCategories members (see D3D11_MESSAGE_CATEGORY). + Number of message severity levels to allow or deny. - Array of message severity levels to allow or deny. Array must have at least NumSeverities members (see D3D11_MESSAGE_SEVERITY). + + Array of message severity levels to allow or deny. Array must have at least NumSeverities members (see D3D11_MESSAGE_SEVERITY). + Number of message IDs to allow or deny. - Array of message IDs to allow or deny. Array must have at least NumIDs members (see D3D11_MESSAGE_ID). + + Array of message IDs to allow or deny. Array must have at least NumIDs members (see D3D11_MESSAGE_ID). + Set the maximum number of messages that can be added to the message queue. - Microsoft Docs: + + Microsoft Docs: + Maximum number of messages that can be added to the message queue. -1 means no limit. Gets the rate at which the video processor produces output frames for an input stream. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Receives a D3D11_VIDEO_PROCESSOR_OUTPUT_RATE value that specifies the output rate. - Receives a Boolean value that specifies how the driver performs frame-rate conversion, if required. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Receives a D3D11_VIDEO_PROCESSOR_OUTPUT_RATE value that specifies the output rate. + + + Receives a Boolean value that specifies how the driver performs frame-rate conversion, if required. - - - - - - - - + +
ValueMeaning
-
TRUE
-
-		 -Repeat frames. + + + + + + + + - - - - + + + + - -
ValueMeaning
+ + +
+
+ TRUE +
+
+ 		+ Repeat frames. -
-
FALSE
-
-		 -Interpolate frames. +
+ + +
+
+ FALSE +
+
+ 		+ Interpolate frames. -
- A pointer to a DXGI_RATIONAL structure. If the output rate is D3D11_VIDEO_PROCESSOR_OUTPUT_RATE_CUSTOM, the method fills in this structure with the exact output rate. Otherwise, this parameter is ignored. +
+ + + A pointer to a DXGI_RATIONAL structure. If the output rate is D3D11_VIDEO_PROCESSOR_OUTPUT_RATE_CUSTOM, the method fills in this structure with the exact output rate. Otherwise, this parameter is ignored. + Get the rasterizer state from the rasterizer stage of the pipeline. - Microsoft Docs: - Address of a pointer to a rasterizer-state interface (see ID3D11RasterizerState) to fill with information from the device. + + Microsoft Docs: + + + Address of a pointer to a rasterizer-state interface (see ID3D11RasterizerState) to fill with information from the device. + Represents a video processor for Microsoft Direct3D 11. - Microsoft Docs: + + Microsoft Docs: + Set the target output buffers for the stream-output stage of the pipeline. - Microsoft Docs: - The number of buffer to bind to the device. A maximum of four output buffers can be set. If less than four are defined by the call, the remaining buffer slots are set to NULL. See Remarks. - The array of output buffers (see ID3D11Buffer) to bind to the device. The buffers must have been created with the D3D11_BIND_STREAM_OUTPUT flag. - Array of offsets to the output buffers from ppSOTargets, one offset for each buffer. The offset values must be in bytes. + + Microsoft Docs: + + + The number of buffer to bind to the device. A maximum of four output buffers can be set. If less than four are defined by the call, the remaining buffer slots are set to NULL. See Remarks. + + + The array of output buffers (see ID3D11Buffer) to bind to the device. The buffers must have been created with the D3D11_BIND_STREAM_OUTPUT flag. + + + Array of offsets to the output buffers from ppSOTargets, one offset for each buffer. The offset values must be in bytes. + Gets the ID3D11ClassLinkage object associated with the current HLSL class. - Microsoft Docs: - A pointer to a ID3D11ClassLinkage interface pointer. + + Microsoft Docs: + + + A pointer to a ID3D11ClassLinkage interface pointer. + Used with ID3D11On12Device::CreateWrappedResourceto override flags that would be inferred by the resource properties or heap properties, including bind flags, misc flags, and CPU access flags. - Microsoft Docs: + + Microsoft Docs: + - Bind flags must be either completely inferred, or completely specified, to allow the graphics driver to scope a general D3D12 resource to something that D3D11 can understand. - + + Bind flags must be either completely inferred, or completely specified, to allow the graphics driver to scope a general D3D12 resource to something that D3D11 can understand. -If a bind flag is specified which is not supported by the provided resource, an error will be returned. - -The following bind flags (D3D11_BIND_FLAG enumeration constants) will not be assumed, and must be specified in order for a resource to be used in such a fashion: - + If a bind flag is specified which is not supported by the provided resource, an error will be returned. -
    -
  • D3D11_BIND_VERTEX_BUFFER -
    • -
  • D3D11_BIND_INDEX_BUFFER -
    • -
  • D3D11_BIND_CONSTANT_BUFFER -
    • -
  • D3D11_BIND_STREAM_OUTPUT -
    • -
  • D3D11_BIND_DECODER -
    • -
  • D3D11_BIND_VIDEO_ENCODER -
    • -
-The following bind flags will be assumed based on the presence of the corresponding D3D12 resource flag, and can be removed by specifying bind flags: - -
    -
  • D3D11_BIND_SHADER_RESOURCE, as long as D3D12_RESOURCE_MISC_DENY_SHADER_RESOURCE is not present -
    • -
  • D3D11_BIND_RENDER_TARGET, if D3D12_RESOURCE_MISC_ALLOW_RENDER_TARGET is present -
    • -
  • D3D11_BIND_DEPTH_STENCIL, if D3D12_RESOURCE_MISC_ALLOW_DEPTH_STENCIL is present -
    • -
  • D3D11_BIND_UNORDERED_ACCESS, if D3D12_RESOURCE_MISC_ALLOW_UNORDERED_ACCESS is present
    • -
-A render target or UAV buffer can be wrapped without overriding flags; but a VB/IB/CB/SO buffer must have bind flags manually specified, since these are mutually exclusive in Direct3D 11. + The following bind flags (D3D11_BIND_FLAG enumeration constants) will not be assumed, and must be specified in order for a resource to be used in such a fashion: + + +
    +
  • + D3D11_BIND_VERTEX_BUFFER +
    • +
  • + D3D11_BIND_INDEX_BUFFER +
    • +
  • + D3D11_BIND_CONSTANT_BUFFER +
    • +
  • + D3D11_BIND_STREAM_OUTPUT +
    • +
  • + D3D11_BIND_DECODER +
    • +
  • + D3D11_BIND_VIDEO_ENCODER +
    • +
+ The following bind flags will be assumed based on the presence of the corresponding D3D12 resource flag, and can be removed by specifying bind flags: + + +
    +
  • + D3D11_BIND_SHADER_RESOURCE, as long as D3D12_RESOURCE_MISC_DENY_SHADER_RESOURCE is not present +
    • +
  • + D3D11_BIND_RENDER_TARGET, if D3D12_RESOURCE_MISC_ALLOW_RENDER_TARGET is present +
    • +
  • + D3D11_BIND_DEPTH_STENCIL, if D3D12_RESOURCE_MISC_ALLOW_DEPTH_STENCIL is present +
    • +
  • D3D11_BIND_UNORDERED_ACCESS, if D3D12_RESOURCE_MISC_ALLOW_UNORDERED_ACCESS is present
    • +
+ A render target or UAV buffer can be wrapped without overriding flags; but a VB/IB/CB/SO buffer must have bind flags manually specified, since these are mutually exclusive in Direct3D 11. + - If misc flags are nonzero, then any specified flags will be OR’d into the final resource desc with inferred flags. - Misc flags can be partially specified in order to add functionality, but misc flags which are implied cannot be masked out. - + + If misc flags are nonzero, then any specified flags will be OR’d into the final resource desc with inferred flags. + Misc flags can be partially specified in order to add functionality, but misc flags which are implied cannot be masked out. -The following misc flags (D3D11_RESOURCE_MISC_FLAG enumeration constants) will not be assumed: - -
    -
  • D3D11_RESOURCE_MISC_GENERATE_MIPS (conflicts with CLAMP). -
    • -
  • D3D11_RESOURCE_MISC_TEXTURECUBE (alters default view behavior). -
    • -
  • D3D11_RESOURCE_MISC_DRAWINDIRECT_ARGS (exclusive with some bind flags). -
    • -
  • D3D11_RESOURCE_MISC_BUFFER_ALLOW_RAW_VIEWS (exclusive with other types of UAVs). -
    • -
  • D3D11_RESOURCE_MISC_BUFFER_STRUCTURED (exclusive with other types of UAVs). -
    • -
  • D3D11_RESOURCE_MISC_RESOURCE_CLAMP (prohibits D3D10 QIs, conflicts with GENERATE_MIPS). -
    • -
  • D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX. It is possible to create a D3D11 keyed mutex resource, create a shared handle for it, and open it via 11on12 or D3D11. -
    • -
-The following misc flags will be assumed, and cannot be removed from the produced resource desc. - If one of these is set, and the D3D12 resource does not support it, creation will fail: - + The following misc flags (D3D11_RESOURCE_MISC_FLAG enumeration constants) will not be assumed: -
    -
  • D3D11_RESOURCE_MISC_SHARED, D3D11_RESOURCE_MISC_SHARED_NTHANDLE, D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE, if appropriate heap misc flags are present. -
    • -
  • D3D11_RESOURCE_MISC_GDI_COMPATIBLE, if D3D12 resource is GDI-compatible. -
    • -
  • D3D11_RESOURCE_MISC_TILED, if D3D12 resource was created via CreateReservedResource. -
    • -
  • D3D11_RESOURCE_MISC_TILE_POOL, if a D3D12 heap was passed in. -
    • -
-The following misc flags are invalid to specify for this API: - -
    -
  • D3D11_RESOURCE_MISC_RESTRICTED_CONTENT, since D3D12 only supports hardware protection. -
    • -
  • D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE_DRIVER does not exist in 12, and cannot be added in after resource creation. -
    • -
  • D3D11_RESOURCE_MISC_GUARDED is only meant to be set by an internal creation mechanism. -
    • -
 +
    +
  • + D3D11_RESOURCE_MISC_GENERATE_MIPS (conflicts with CLAMP). +
    • +
  • + D3D11_RESOURCE_MISC_TEXTURECUBE (alters default view behavior). +
    • +
  • + D3D11_RESOURCE_MISC_DRAWINDIRECT_ARGS (exclusive with some bind flags). +
    • +
  • + D3D11_RESOURCE_MISC_BUFFER_ALLOW_RAW_VIEWS (exclusive with other types of UAVs). +
    • +
  • + D3D11_RESOURCE_MISC_BUFFER_STRUCTURED (exclusive with other types of UAVs). +
    • +
  • + D3D11_RESOURCE_MISC_RESOURCE_CLAMP (prohibits D3D10 QIs, conflicts with GENERATE_MIPS). +
    • +
  • + D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX. It is possible to create a D3D11 keyed mutex resource, create a shared handle for it, and open it via 11on12 or D3D11. +
    • +
+ The following misc flags will be assumed, and cannot be removed from the produced resource desc. + If one of these is set, and the D3D12 resource does not support it, creation will fail: + + +
    +
  • + D3D11_RESOURCE_MISC_SHARED, D3D11_RESOURCE_MISC_SHARED_NTHANDLE, D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE, if appropriate heap misc flags are present. +
    • +
  • + D3D11_RESOURCE_MISC_GDI_COMPATIBLE, if D3D12 resource is GDI-compatible. +
    • +
  • + D3D11_RESOURCE_MISC_TILED, if D3D12 resource was created via CreateReservedResource. +
    • +
  • + D3D11_RESOURCE_MISC_TILE_POOL, if a D3D12 heap was passed in. +
    • +
+ The following misc flags are invalid to specify for this API: + + +
    +
  • + D3D11_RESOURCE_MISC_RESTRICTED_CONTENT, since D3D12 only supports hardware protection. +
    • +
  • + D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE_DRIVER does not exist in 12, and cannot be added in after resource creation. +
    • +
  • + D3D11_RESOURCE_MISC_GUARDED is only meant to be set by an internal creation mechanism. +
    • +
+ - The CPUAccessFlags are not inferred from the D3D12 resource. - This is because all resources are treated as D3D11_USAGE_DEFAULT, so CPUAccessFlags force validation which assumes Map of default buffers or textures. - Wrapped resources do not support Map(DISCARD). - Wrapped resources do not support Map(NO_OVERWRITE), but that can be implemented by mapping the underlying D3D12 resource instead. - Issuing a Map call on a wrapped resource will synchronize with all D3D11 work submitted against that resource, unless the DO_NOT_WAIT flag was used. + + The CPUAccessFlags are not inferred from the D3D12 resource. + This is because all resources are treated as D3D11_USAGE_DEFAULT, so CPUAccessFlags force validation which assumes Map of default buffers or textures. + Wrapped resources do not support Map(DISCARD). + Wrapped resources do not support Map(NO_OVERWRITE), but that can be implemented by mapping the underlying D3D12 resource instead. + Issuing a Map call on a wrapped resource will synchronize with all D3D11 work submitted against that resource, unless the DO_NOT_WAIT flag was used. + The size of each element in the buffer structure (in bytes) when the buffer represents a structured buffer. @@ -3592,38 +4976,60 @@ The following misc flags are invalid to specify for this API: This shader-reflection interface provides access to a constant buffer. - Microsoft Docs: + + Microsoft Docs: + Establishes the session key for a cryptographic session. - Microsoft Docs: - A pointer to the ID3D11CryptoSession interface of the cryptographic session. - The size of the pData byte array, in bytes. + + Microsoft Docs: + + + A pointer to the ID3D11CryptoSession interface of the cryptographic session. + + + The size of the pData byte array, in bytes. + A pointer to a byte array that contains the encrypted session key. Retrieves information about the specified step in the trace. - Microsoft Docs: - The index of the step within the trace. The range of the index is [0...NumTraceSteps-1], where NumTraceSteps is a member of the D3D11_TRACE_STATS structure. You can retrieve information about a step in any step order. - A pointer to a D3D11_TRACE_STEP structure. GetStep fills the members of this structure with information about the trace step that is specified by the stepIndex parameter. + + Microsoft Docs: + + + The index of the step within the trace. The range of the index is [0...NumTraceSteps-1], where NumTraceSteps is a member of the D3D11_TRACE_STATS structure. You can retrieve information about a step in any step order. + + + A pointer to a D3D11_TRACE_STEP structure. GetStep fills the members of this structure with information about the trace step that is specified by the stepIndex parameter. + Draw indexed, instanced, GPU-generated primitives. - Microsoft Docs: - A pointer to an ID3D11Buffer, which is a buffer containing the GPU generated primitives. - Offset in pBufferForArgs to the start of the GPU generated primitives. + + Microsoft Docs: + + + A pointer to an ID3D11Buffer, which is a buffer containing the GPU generated primitives. + + + Offset in pBufferForArgs to the start of the GPU generated primitives. + Copies a region from a source resource to a destination resource. - Microsoft Docs: + + Microsoft Docs: + A pointer to the destination resource. Destination subresource index. The x-coordinate of the upper-left corner of the destination region. @@ -3631,42 +5037,62 @@ The following misc flags are invalid to specify for this API: The z-coordinate of the upper-left corner of the destination region. For a 1D or 2D subresource, this must be zero. A pointer to the source resource. Source subresource index. - A pointer to a 3D box that defines the region of the source subresource that CopySubresourceRegion1 can copy. If NULL, CopySubresourceRegion1 copies the entire source subresource. The box must fit within the source resource. + + A pointer to a 3D box that defines the region of the source subresource that CopySubresourceRegion1 can copy. If NULL, CopySubresourceRegion1 copies the entire source subresource. The box must fit within the source resource. -An empty box results in a no-op. A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. When the box is empty, CopySubresourceRegion1 doesn't perform a copy operation. - A D3D11_COPY_FLAGS-typed value that specifies how to perform the copy operation. If you specify zero for no copy option, CopySubresourceRegion1 behaves like ID3D11DeviceContext::CopySubresourceRegion. For existing display drivers that can't process these flags, the runtime doesn't use them. + An empty box results in a no-op. A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. When the box is empty, CopySubresourceRegion1 doesn't perform a copy operation. + + + A D3D11_COPY_FLAGS-typed value that specifies how to perform the copy operation. If you specify zero for no copy option, CopySubresourceRegion1 behaves like ID3D11DeviceContext::CopySubresourceRegion. For existing display drivers that can't process these flags, the runtime doesn't use them. + Set a message category to break on when a message with that category passes through the storage filter. - Microsoft Docs: - Message category to break on (see D3D11_MESSAGE_CATEGORY). + + Microsoft Docs: + + + Message category to break on (see D3D11_MESSAGE_CATEGORY). + Turns this breaking condition on or off (true for on, false for off). Get the vertex shader currently set on the device. - Microsoft Docs: - Address of a pointer to a vertex shader (see ID3D11VertexShader) to be returned by the method. - Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + + Microsoft Docs: + + + Address of a pointer to a vertex shader (see ID3D11VertexShader) to be returned by the method. + + + Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + The number of class-instance elements in the array. Get the constant buffers used by the geometry shader pipeline stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + + Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + Unordered resource support options for a compute shader resource (see ID3D11Device::CheckFeatureSupport). - Microsoft Docs: + + Microsoft Docs: + @@ -3694,24 +5120,31 @@ An empty box results in a no-op. A box is empty if the top value is greater than Format supports a typed store. - Format supports logic operations in blend state. + + Format supports logic operations in blend state. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Format supports tiled resources. + + Format supports tiled resources. -Direct3D 11:  This value is not supported until Direct3D 11.2. + Direct3D 11:  This value is not supported until Direct3D 11.2. + - Format supports shareable resources. -
Note  DXGI_FORMAT_R8G8B8A8_UNORM and DXGI_FORMAT_R8G8B8A8_UNORM_SRGB are never shareable when using feature level 9, even if the device indicates optional feature support for D3D11_FORMAT_SUPPORT_SHAREABLE. - Attempting to create shared resources with DXGI formats DXGI_FORMAT_R8G8B8A8_UNORM and DXGI_FORMAT_R8G8B8A8_UNORM_SRGB will always fail unless the feature level is 10_0 or higher. -
-
 
+ + Format supports shareable resources. +
+ Note  DXGI_FORMAT_R8G8B8A8_UNORM and DXGI_FORMAT_R8G8B8A8_UNORM_SRGB are never shareable when using feature level 9, even if the device indicates optional feature support for D3D11_FORMAT_SUPPORT_SHAREABLE. + Attempting to create shared resources with DXGI formats DXGI_FORMAT_R8G8B8A8_UNORM and DXGI_FORMAT_R8G8B8A8_UNORM_SRGB will always fail unless the feature level is 10_0 or higher. +
+
 
-Direct3D 11:  This value is not supported until Direct3D 11.2. + Direct3D 11:  This value is not supported until Direct3D 11.2. + Format supports multi-plane overlays. @@ -3719,36 +5152,58 @@ An empty box results in a no-op. A box is empty if the top value is greater than Sets an array of views for an unordered resource. - Microsoft Docs: + + Microsoft Docs: + Index of the first element in the zero-based array to begin setting (ranges from 0 to D3D11_1_UAV_SLOT_COUNT - 1). D3D11_1_UAV_SLOT_COUNT is defined as 64. - Number of views to set (ranges from 0 to D3D11_1_UAV_SLOT_COUNT - StartSlot). - A pointer to an array of ID3D11UnorderedAccessView pointers to be set by the method. - An array of append and consume buffer offsets. A value of -1 indicates to keep the current offset. Any other values set the hidden counter - for that appendable and consumable UAV. pUAVInitialCounts is only relevant for UAVs that were created with either - D3D11_BUFFER_UAV_FLAG_APPEND or D3D11_BUFFER_UAV_FLAG_COUNTER specified - when the UAV was created; otherwise, the argument is ignored. + + Number of views to set (ranges from 0 to D3D11_1_UAV_SLOT_COUNT - StartSlot). + + + A pointer to an array of ID3D11UnorderedAccessView pointers to be set by the method. + + + An array of append and consume buffer offsets. A value of -1 indicates to keep the current offset. Any other values set the hidden counter + for that appendable and consumable UAV. pUAVInitialCounts is only relevant for UAVs that were created with either + D3D11_BUFFER_UAV_FLAG_APPEND or D3D11_BUFFER_UAV_FLAG_COUNTER specified + when the UAV was created; otherwise, the argument is ignored. + Mark the beginning of a series of commands. - Microsoft Docs: - A pointer to an ID3D11Asynchronous interface. + + Microsoft Docs: + + + A pointer to an ID3D11Asynchronous interface. + Sets the input signature of the function-linking-graph. - Microsoft Docs: - An array of D3D11_PARAMETER_DESC structures for the parameters of the input signature. - The number of input parameters in the pInputParameters array. - A pointer to a variable that receives a pointer to the ID3D11LinkingNode interface that represents the input signature of the function-linking-graph. + + Microsoft Docs: + + + An array of D3D11_PARAMETER_DESC structures for the parameters of the input signature. + + + The number of input parameters in the pInputParameters array. + + + A pointer to a variable that receives a pointer to the ID3D11LinkingNode interface that represents the input signature of the function-linking-graph. + Describes an instance of a geometry shader to trace. - Microsoft Docs: + + Microsoft Docs: + @@ -3757,69 +5212,97 @@ An empty box results in a no-op. A box is empty if the top value is greater than Description of a vertex element in a vertex buffer in an output slot. - Microsoft Docs: + + Microsoft Docs: + Zero-based, stream number. - Type of output element; possible values include: "POSITION", "NORMAL", or "TEXCOORD0". - Note that if SemanticName is NULL then - ComponentCount can be greater than 4 and the described entry will be a gap in the stream out where no data will be written. + + Type of output element; possible values include: "POSITION", "NORMAL", or "TEXCOORD0". + Note that if SemanticName is NULL then + ComponentCount can be greater than 4 and the described entry will be a gap in the stream out where no data will be written. + Output element's zero-based index. Should be used if, for example, you have more than one texture coordinate stored in each vertex. - Which component of the entry to begin writing out to. Valid values are 0 to 3. For example, if you only wish to output to the y and z components - of a position, then StartComponent should be 1 and ComponentCount should be 2. + + Which component of the entry to begin writing out to. Valid values are 0 to 3. For example, if you only wish to output to the y and z components + of a position, then StartComponent should be 1 and ComponentCount should be 2. + - The number of components of the entry to write out to. Valid values are 1 to 4. For example, if you only wish to output to the y and z components - of a position, then StartComponent should be 1 and ComponentCount should be 2. Note that if SemanticName is NULL then - ComponentCount can be greater than 4 and the described entry will be a gap in the stream out where no data will be written. + + The number of components of the entry to write out to. Valid values are 1 to 4. For example, if you only wish to output to the y and z components + of a position, then StartComponent should be 1 and ComponentCount should be 2. Note that if SemanticName is NULL then + ComponentCount can be greater than 4 and the described entry will be a gap in the stream out where no data will be written. + - The associated stream output buffer that is bound to the pipeline - (see ID3D11DeviceContext::SOSetTargets). - The valid range for OutputSlot is 0 to 3. + + The associated stream output buffer that is bound to the pipeline + (see ID3D11DeviceContext::SOSetTargets). + The valid range for OutputSlot is 0 to 3. + Sets the constant buffers that the hull-shader stage of the pipeline uses. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + Array of constant buffers being given to the device. - An array that holds the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. Each offset must be a multiple of 16 constants. - An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + + An array that holds the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. Each offset must be a multiple of 16 constants. + + + An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + The device context interface represents a device context; it is used to render commands. ID3D11DeviceContext1 adds new methods to those in ID3D11DeviceContext. - Microsoft Docs: + + Microsoft Docs: + A buffer interface accesses a buffer resource, which is unstructured memory. Buffers typically store vertex or index data. - Microsoft Docs: + + Microsoft Docs: + Creates a deferred context, which can record command lists. - Microsoft Docs: + + Microsoft Docs: + Reserved for future use. Pass 0. - Upon completion of the method, the passed pointer to an ID3D11DeviceContext3 interface pointer is initialized. + + Upon completion of the method, the passed pointer to an ID3D11DeviceContext3 interface pointer is initialized. + Describes a shader variable. - Microsoft Docs: + + Microsoft Docs: + @@ -3832,7 +5315,9 @@ An empty box results in a no-op. A box is empty if the top value is greater than Size of the variable (in bytes). - A combination of D3D_SHADER_VARIABLE_FLAGS-typed values that are combined by using a bitwise OR operation. The resulting value identifies shader-variable properties. + + A combination of D3D_SHADER_VARIABLE_FLAGS-typed values that are combined by using a bitwise OR operation. The resulting value identifies shader-variable properties. + The default value for initializing the variable. @@ -3852,7 +5337,9 @@ An empty box results in a no-op. A box is empty if the top value is greater than Specifies how to access a resource that is used in a video processor output view. - Microsoft Docs: + + Microsoft Docs: + @@ -3867,27 +5354,41 @@ An empty box results in a no-op. A box is empty if the top value is greater than Defines constants that specify TBD. - Microsoft Docs: + + Microsoft Docs: + - Specifies the support available when [D3D11_FEATURE_DATA_D3D11_OPTIONS::ExtendedResourceSharing](./ns-d3d11-d3d11_feature_data_d3d11_options.md) is FALSE. + + Specifies the support available when [D3D11_FEATURE_DATA_D3D11_OPTIONS::ExtendedResourceSharing](./ns-d3d11-d3d11_feature_data_d3d11_options.md) is FALSE. + - Specifies the support available when [D3D11_FEATURE_DATA_D3D11_OPTIONS::ExtendedResourceSharing](./ns-d3d11-d3d11_feature_data_d3d11_options.md) is TRUE. + + Specifies the support available when [D3D11_FEATURE_DATA_D3D11_OPTIONS::ExtendedResourceSharing](./ns-d3d11-d3d11_feature_data_d3d11_options.md) is TRUE. + - Specifies the support available when [D3D11_FEATURE_DATA_D3D11_OPTIONS4::ExtendedNV12SharedTextureSupported](../d3d11_4/ns-d3d11_4-d3d11_feature_data_d3d11_options4.md) is TRUE. Also see [Extended NV12 texture support](/windows/win32/direct3d11/direct3d-11-4-features#extended-nv12-texture-support). + + Specifies the support available when [D3D11_FEATURE_DATA_D3D11_OPTIONS4::ExtendedNV12SharedTextureSupported](../d3d11_4/ns-d3d11_4-d3d11_feature_data_d3d11_options4.md) is TRUE. Also see [Extended NV12 texture support](/windows/win32/direct3d11/direct3d-11-4-features#extended-nv12-texture-support). + - Specifies that DXGI_FORMAT_R11G11B10_FLOAT supports NT handle sharing. Also see CreateSharedHandle. + + Specifies that DXGI_FORMAT_R11G11B10_FLOAT supports NT handle sharing. Also see CreateSharedHandle. + Clears the depth-stencil resource. - Microsoft Docs: + + Microsoft Docs: + Pointer to the depth stencil to be cleared. - Identify the type of data to clear (see D3D11_CLEAR_FLAG). + + Identify the type of data to clear (see D3D11_CLEAR_FLAG). + Clear the depth buffer with this value. This value will be clamped between 0 and 1. Clear the stencil buffer with this value. @@ -3895,80 +5396,124 @@ An empty box results in a no-op. A box is empty if the top value is greater than Contains the response to a D3D11_AUTHENTICATED_QUERY_PROTECTION query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + - A D3D11_AUTHENTICATED_PROTECTION_FLAGS union that specifies the protection level. + + A D3D11_AUTHENTICATED_PROTECTION_FLAGS union that specifies the protection level. + This interface encapsulates methods for querying information from the GPU. - Microsoft Docs: - Pointer to a query description (see D3D11_QUERY_DESC). - Address of a pointer to the query object created (see ID3D11Query). + + Microsoft Docs: + + + Pointer to a query description (see D3D11_QUERY_DESC). + + + Address of a pointer to the query object created (see ID3D11Query). + Gets the constant buffers that the domain-shader stage uses. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + Array of constant buffer interface pointers to be returned by the method. - A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. - A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + + A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. + + + A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + A pixel-shader interface manages an executable program (a pixel shader) that controls the pixel-shader stage. - Microsoft Docs: + + Microsoft Docs: + Gets the initialization flags associated with the deferred context that created the command list. - Microsoft Docs: + + Microsoft Docs: + Sets the minimum level-of-detail (LOD) for a resource. - Microsoft Docs: - A pointer to an ID3D11Resource that represents the resource. - The level-of-detail, which ranges between 0 and the maximum number of mipmap levels of the resource. For example, the maximum number of mipmap levels of a 1D texture is specified in the MipLevels member of the D3D11_TEXTURE1D_DESC structure. + + Microsoft Docs: + + + A pointer to an ID3D11Resource that represents the resource. + + + The level-of-detail, which ranges between 0 and the maximum number of mipmap levels of the resource. For example, the maximum number of mipmap levels of a 1D texture is specified in the MipLevels member of the D3D11_TEXTURE1D_DESC structure. + Describes the blend state for a render target. - Microsoft Docs: + + Microsoft Docs: + Enable (or disable) blending. - This blend option specifies the operation to perform on the RGB value that the pixel shader outputs. The BlendOp member defines how to combine the SrcBlend and DestBlend operations. + + This blend option specifies the operation to perform on the RGB value that the pixel shader outputs. The BlendOp member defines how to combine the SrcBlend and DestBlend operations. + - This blend option specifies the operation to perform on the current RGB value in the render target. The BlendOp member defines how to combine the SrcBlend and DestBlend operations. + + This blend option specifies the operation to perform on the current RGB value in the render target. The BlendOp member defines how to combine the SrcBlend and DestBlend operations. + - This blend operation defines how to combine the SrcBlend and DestBlend operations. + + This blend operation defines how to combine the SrcBlend and DestBlend operations. + - This blend option specifies the operation to perform on the alpha value that the pixel shader outputs. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + + This blend option specifies the operation to perform on the alpha value that the pixel shader outputs. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + - This blend option specifies the operation to perform on the current alpha value in the render target. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + + This blend option specifies the operation to perform on the current alpha value in the render target. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + - This blend operation defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + + This blend operation defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + A write mask. @@ -3976,7 +5521,9 @@ An empty box results in a no-op. A box is empty if the top value is greater than Specifies the inverse telecine (IVTC) capabilities of a video processor. - Microsoft Docs: + + Microsoft Docs: + @@ -4012,7 +5559,9 @@ An empty box results in a no-op. A box is empty if the top value is greater than Specifies the video rotation states. - Microsoft Docs: + + Microsoft Docs: + @@ -4030,17 +5579,25 @@ An empty box results in a no-op. A box is empty if the top value is greater than Specifies flags that indicate the most efficient methods for performing video processing operations. - Microsoft Docs: + + Microsoft Docs: + - Multi-plane overlay hardware can perform the rotation operation more efficiently than the ID3D11VideoContext::VideoProcessorBlt method. + + Multi-plane overlay hardware can perform the rotation operation more efficiently than the ID3D11VideoContext::VideoProcessorBlt method. + - Multi-plane overlay hardware can perform the scaling operation more efficiently than the ID3D11VideoContext::VideoProcessorBlt method. + + Multi-plane overlay hardware can perform the scaling operation more efficiently than the ID3D11VideoContext::VideoProcessorBlt method. + - Multi-plane overlay hardware can perform the colorspace conversion operation more efficiently than the ID3D11VideoContext::VideoProcessorBlt method. + + Multi-plane overlay hardware can perform the colorspace conversion operation more efficiently than the ID3D11VideoContext::VideoProcessorBlt method. + The video processor output data should be at least triple buffered for optimal performance. @@ -4048,15 +5605,23 @@ An empty box results in a no-op. A box is empty if the top value is greater than Sets the reference rasterizer's default race-condition tracking options for the specified resource types. - Microsoft Docs: - A D3D11_SHADER_TRACKING_RESOURCE_TYPE-typed value that specifies the type of resource to track. - A combination of D3D11_SHADER_TRACKING_OPTIONS-typed flags that are combined by using a bitwise OR operation. The resulting value identifies tracking options. If a flag is present, the tracking option that the flag represents is set to "on," otherwise the tracking option is set to "off." + + Microsoft Docs: + + + A D3D11_SHADER_TRACKING_RESOURCE_TYPE-typed value that specifies the type of resource to track. + + + A combination of D3D11_SHADER_TRACKING_OPTIONS-typed flags that are combined by using a bitwise OR operation. The resulting value identifies tracking options. If a flag is present, the tracking option that the flag represents is set to "on," otherwise the tracking option is set to "off." + Describes Direct3D 11.4 feature options in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + @@ -4065,15 +5630,21 @@ An empty box results in a no-op. A box is empty if the top value is greater than Set a message identifier to break on when a message with that identifier passes through the storage filter. - Microsoft Docs: - Message identifier to break on (see D3D11_MESSAGE_ID). + + Microsoft Docs: + + + Message identifier to break on (see D3D11_MESSAGE_ID). + Turns this breaking condition on or off (true for on, false for off). Specifies values for the luminance range of YUV data. - Microsoft Docs: + + Microsoft Docs: + @@ -4088,25 +5659,37 @@ An empty box results in a no-op. A box is empty if the top value is greater than Get the properties of the texture resource. - Microsoft Docs: - Pointer to a resource description (see D3D11_TEXTURE1D_DESC). + + Microsoft Docs: + + + Pointer to a resource description (see D3D11_TEXTURE1D_DESC). + Get application-defined data from a device child. - Microsoft Docs: + + Microsoft Docs: + Guid associated with the data. - A pointer to a variable that on input contains the size, in bytes, of the buffer that pData points to, and on output contains the size, in bytes, of the amount of data that - GetPrivateDataretrieved. - A pointer to a buffer that - GetPrivateDatafills with data from the device child if pDataSize points to a value that specifies a buffer large enough to hold the data. + + A pointer to a variable that on input contains the size, in bytes, of the buffer that pData points to, and on output contains the size, in bytes, of the amount of data that + GetPrivateDataretrieved. + + + A pointer to a buffer that + GetPrivateDatafills with data from the device child if pDataSize points to a value that specifies a buffer large enough to hold the data. + Specifies fence options. - Microsoft Docs: + + Microsoft Docs: + @@ -4121,185 +5704,241 @@ An empty box results in a no-op. A box is empty if the top value is greater than Identifies options for resources. - Microsoft Docs: + + Microsoft Docs: + - Enables MIP map generation by using ID3D11DeviceContext::GenerateMips on a texture resource. The resource must be created with the bind flags that specify that the resource is a render target and a shader resource. + + Enables MIP map generation by using ID3D11DeviceContext::GenerateMips on a texture resource. The resource must be created with the bind flags that specify that the resource is a render target and a shader resource. + - Enables resource data sharing between two or more Direct3D devices. The only resources that can be shared are 2D non-mipmapped textures. - + + Enables resource data sharing between two or more Direct3D devices. The only resources that can be shared are 2D non-mipmapped textures. -D3D11_RESOURCE_MISC_SHARED and D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX are mutually exclusive. - -WARP and REF devices do not support shared resources. - If you try to create a resource with this flag on either a WARP or REF device, the create method will return an E_OUTOFMEMORY error code. - + D3D11_RESOURCE_MISC_SHARED and D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX are mutually exclusive. -
Note  Starting with Windows 8, WARP devices fully support shared resources. -
-
 
-
Note  Starting with Windows 8, we recommend that you enable resource data sharing between two or more Direct3D devices by using a combination of the D3D11_RESOURCE_MISC_SHARED_NTHANDLE and D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX flags instead. -
-
 
 + + WARP and REF devices do not support shared resources. + If you try to create a resource with this flag on either a WARP or REF device, the create method will return an E_OUTOFMEMORY error code. + + +
+ Note  Starting with Windows 8, WARP devices fully support shared resources. +
+
 
+
+ Note  Starting with Windows 8, we recommend that you enable resource data sharing between two or more Direct3D devices by using a combination of the D3D11_RESOURCE_MISC_SHARED_NTHANDLE and D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX flags instead. +
+
 
+ - Sets a resource to be a cube texture created from a Texture2DArray that contains 6 textures. + + Sets a resource to be a cube texture created from a Texture2DArray that contains 6 textures. + Enables instancing of GPU-generated content. - Enables a resource as a byte address buffer. + + Enables a resource as a byte address buffer. + - Enables a resource as a structured buffer. + + Enables a resource as a structured buffer. + - Enables a resource with MIP map clamping for use with ID3D11DeviceContext::SetResourceMinLOD. + + Enables a resource with MIP map clamping for use with ID3D11DeviceContext::SetResourceMinLOD. + - Enables the resource to be synchronized by using the IDXGIKeyedMutex::AcquireSync and - IDXGIKeyedMutex::ReleaseSync APIs. - The following Direct3D 11 resource creation APIs, that take D3D11_RESOURCE_MISC_FLAG parameters, have been extended to support the new flag. + + Enables the resource to be synchronized by using the IDXGIKeyedMutex::AcquireSync and + IDXGIKeyedMutex::ReleaseSync APIs. + The following Direct3D 11 resource creation APIs, that take D3D11_RESOURCE_MISC_FLAG parameters, have been extended to support the new flag. - -If you call any of these methods with the D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX flag set, the interface returned will support the IDXGIKeyedMutex interface. You can retrieve a pointer to the IDXGIKeyedMutex interface from the resource by using IUnknown::QueryInterface. The IDXGIKeyedMutex interface implements the IDXGIKeyedMutex::AcquireSync and IDXGIKeyedMutex::ReleaseSync APIs to synchronize access to the surface. The device that creates the surface, and any other device that opens the surface by using OpenSharedResource, must call IDXGIKeyedMutex::AcquireSync before they issue any rendering commands to the surface. When those devices finish rendering, they must call IDXGIKeyedMutex::ReleaseSync. - + + If you call any of these methods with the D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX flag set, the interface returned will support the IDXGIKeyedMutex interface. You can retrieve a pointer to the IDXGIKeyedMutex interface from the resource by using IUnknown::QueryInterface. The IDXGIKeyedMutex interface implements the IDXGIKeyedMutex::AcquireSync and IDXGIKeyedMutex::ReleaseSync APIs to synchronize access to the surface. The device that creates the surface, and any other device that opens the surface by using OpenSharedResource, must call IDXGIKeyedMutex::AcquireSync before they issue any rendering commands to the surface. When those devices finish rendering, they must call IDXGIKeyedMutex::ReleaseSync. -D3D11_RESOURCE_MISC_SHARED and D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX are mutually exclusive. - -WARP and REF devices do not support shared resources. - If you try to create a resource with this flag on either a WARP or REF device, the create method will return an E_OUTOFMEMORY error code. - + D3D11_RESOURCE_MISC_SHARED and D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX are mutually exclusive. -
Note  Starting with Windows 8, WARP devices fully support shared resources. -
-
 
 + + WARP and REF devices do not support shared resources. + If you try to create a resource with this flag on either a WARP or REF device, the create method will return an E_OUTOFMEMORY error code. + + +
+ Note  Starting with Windows 8, WARP devices fully support shared resources. +
+
 
+ - Enables a resource compatible with GDI. You must set the D3D11_RESOURCE_MISC_GDI_COMPATIBLE flag on surfaces that you use with GDI. Setting the D3D11_RESOURCE_MISC_GDI_COMPATIBLE flag allows GDI rendering on the surface via IDXGISurface1::GetDC. - + + Enables a resource compatible with GDI. You must set the D3D11_RESOURCE_MISC_GDI_COMPATIBLE flag on surfaces that you use with GDI. Setting the D3D11_RESOURCE_MISC_GDI_COMPATIBLE flag allows GDI rendering on the surface via IDXGISurface1::GetDC. -Consider the following programming tips for using D3D11_RESOURCE_MISC_GDI_COMPATIBLE when you create a texture or use that texture in a swap chain: -
    -
  • D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX and D3D11_RESOURCE_MISC_GDI_COMPATIBLE are mutually exclusive. Therefore, do not use them together.
    • -
  • D3D11_RESOURCE_MISC_RESOURCE_CLAMP and D3D11_RESOURCE_MISC_GDI_COMPATIBLE are mutually exclusive. Therefore, do not use them together.
    • -
  • You must bind the texture as a render target for the output-merger stage. For example, set the D3D11_BIND_RENDER_TARGET flag in the BindFlags member of the D3D11_TEXTURE2D_DESC structure. -
    • -
  • You must set the maximum number of MIP map levels to 1. For example, set the MipLevels member of the D3D11_TEXTURE2D_DESC structure to 1. -
    • -
  • You must specify that the texture requires read and write access by the GPU. For example, set the Usage member of the D3D11_TEXTURE2D_DESC structure to D3D11_USAGE_DEFAULT. -
    • -
  • -You must set the texture format to one of the following types. + Consider the following programming tips for using D3D11_RESOURCE_MISC_GDI_COMPATIBLE when you create a texture or use that texture in a swap chain: -
      -
    • DXGI_FORMAT_B8G8R8A8_UNORM
      • -
    • DXGI_FORMAT_B8G8R8A8_TYPELESS
      • -
    • DXGI_FORMAT_B8G8R8A8_UNORM_SRGB
      • -
    For example, set the Format member of the D3D11_TEXTURE2D_DESC structure to one of these types. -
    • -
  • You cannot use D3D11_RESOURCE_MISC_GDI_COMPATIBLE with multisampling. Therefore, set the Count member of the DXGI_SAMPLE_DESC structure to 1. Then, set the SampleDesc member of the D3D11_TEXTURE2D_DESC structure to this DXGI_SAMPLE_DESC structure. -
    • -
 +
    +
  • D3D11_RESOURCE_MISC_SHARED_KEYEDMUTEX and D3D11_RESOURCE_MISC_GDI_COMPATIBLE are mutually exclusive. Therefore, do not use them together.
    • +
  • D3D11_RESOURCE_MISC_RESOURCE_CLAMP and D3D11_RESOURCE_MISC_GDI_COMPATIBLE are mutually exclusive. Therefore, do not use them together.
    • +
  • + You must bind the texture as a render target for the output-merger stage. For example, set the D3D11_BIND_RENDER_TARGET flag in the BindFlags member of the D3D11_TEXTURE2D_DESC structure. +
    • +
  • + You must set the maximum number of MIP map levels to 1. For example, set the MipLevels member of the D3D11_TEXTURE2D_DESC structure to 1. +
    • +
  • + You must specify that the texture requires read and write access by the GPU. For example, set the Usage member of the D3D11_TEXTURE2D_DESC structure to D3D11_USAGE_DEFAULT. +
    • +
  • + You must set the texture format to one of the following types. + +
      +
    • DXGI_FORMAT_B8G8R8A8_UNORM
      • +
    • DXGI_FORMAT_B8G8R8A8_TYPELESS
      • +
    • DXGI_FORMAT_B8G8R8A8_UNORM_SRGB
      • +
    For example, set the Format member of the D3D11_TEXTURE2D_DESC structure to one of these types. +
    • +
  • + You cannot use D3D11_RESOURCE_MISC_GDI_COMPATIBLE with multisampling. Therefore, set the Count member of the DXGI_SAMPLE_DESC structure to 1. Then, set the SampleDesc member of the D3D11_TEXTURE2D_DESC structure to this DXGI_SAMPLE_DESC structure. +
    • +
+ - Set this flag to enable the use of NT HANDLE values when you create a shared resource. By enabling this flag, you deprecate the use of existing HANDLE values. + + Set this flag to enable the use of NT HANDLE values when you create a shared resource. By enabling this flag, you deprecate the use of existing HANDLE values. -The value specifies a new shared resource type that directs the runtime to use NT HANDLE values for the shared resource. The runtime then must confirm that the shared resource works on all hardware at the specified feature level. - + The value specifies a new shared resource type that directs the runtime to use NT HANDLE values for the shared resource. The runtime then must confirm that the shared resource works on all hardware at the specified feature level. -Without this flag set, the runtime does not strictly validate shared resource parameters (that is, formats, flags, usage, and so on). When the runtime does not validate shared resource parameters, behavior of much of the Direct3D API might be undefined and might vary from driver to driver. -Direct3D 11 and earlier:  This value is not supported until Direct3D 11.1. + Without this flag set, the runtime does not strictly validate shared resource parameters (that is, formats, flags, usage, and so on). When the runtime does not validate shared resource parameters, behavior of much of the Direct3D API might be undefined and might vary from driver to driver. + + Direct3D 11 and earlier:  This value is not supported until Direct3D 11.1. + - Set this flag to indicate that the resource might contain protected content; therefore, the operating system should use the resource only when the driver and hardware support content protection. If the driver and hardware do not support content protection and you try to create a resource with this flag, the resource creation fails. + + Set this flag to indicate that the resource might contain protected content; therefore, the operating system should use the resource only when the driver and hardware support content protection. If the driver and hardware do not support content protection and you try to create a resource with this flag, the resource creation fails. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Set this flag to indicate that the operating system restricts access to the shared surface. You can use this flag together with the D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE_DRIVER flag and only when you create a shared surface. The process that creates the shared resource can always open the shared resource. + + Set this flag to indicate that the operating system restricts access to the shared surface. You can use this flag together with the D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE_DRIVER flag and only when you create a shared surface. The process that creates the shared resource can always open the shared resource. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Set this flag to indicate that the driver restricts access to the shared surface. You can use this flag in conjunction with the D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE flag and only when you create a shared surface. The process that creates the shared resource can always open the shared resource. + + Set this flag to indicate that the driver restricts access to the shared surface. You can use this flag in conjunction with the D3D11_RESOURCE_MISC_RESTRICT_SHARED_RESOURCE flag and only when you create a shared surface. The process that creates the shared resource can always open the shared resource. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Set this flag to indicate that the resource is guarded. Such a resource is returned by the IDCompositionSurface::BeginDraw (DirectComposition) and ISurfaceImageSourceNative::BeginDraw (Windows Runtime) APIs. For these APIs, you provide a region of interest (ROI) on a surface to update. This surface isn't compatible with multiple render targets (MRT). + + Set this flag to indicate that the resource is guarded. Such a resource is returned by the IDCompositionSurface::BeginDraw (DirectComposition) and ISurfaceImageSourceNative::BeginDraw (Windows Runtime) APIs. For these APIs, you provide a region of interest (ROI) on a surface to update. This surface isn't compatible with multiple render targets (MRT). -A guarded resource automatically restricts all writes to the region that is related to one of the preceding APIs. Additionally, the resource enforces access to the ROI with these restrictions: + A guarded resource automatically restricts all writes to the region that is related to one of the preceding APIs. Additionally, the resource enforces access to the ROI with these restrictions: - -Direct3D 11:  This value is not supported until Direct3D 11.1. + + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Set this flag to indicate that the resource is a tile pool. + + Set this flag to indicate that the resource is a tile pool. -Direct3D 11:  This value is not supported until Direct3D 11.2. + Direct3D 11:  This value is not supported until Direct3D 11.2. + - Set this flag to indicate that the resource is a tiled resource. + + Set this flag to indicate that the resource is a tiled resource. -Direct3D 11:  This value is not supported until Direct3D 11.2. + Direct3D 11:  This value is not supported until Direct3D 11.2. + - Set this flag to indicate that the resource should be created such that it will be protected by the hardware. Resource creation will fail if hardware content protection is not supported. + + Set this flag to indicate that the resource should be created such that it will be protected by the hardware. Resource creation will fail if hardware content protection is not supported. -This flag has the following restrictions: + This flag has the following restrictions: -
    -
  • This flag cannot be used with the following D3D11_USAGE values:
      -
    • D3D11_USAGE_DYNAMIC
      • -
    • D3D11_USAGE_STAGING
      • -
    -
    • -
  • This flag cannot be used with the following D3D11_BIND_FLAG values.
      -
    • D3D11_BIND_VERTEX_BUFFER
      • -
    • D3D11_BIND_INDEX_BUFFER
      • -
    -
    • -
  • No CPU access flags can be specified.
    • -
-
Note  

Creating a texture using this flag does not automatically guarantee that hardware protection will be enabled for the underlying allocation. Some implementations require that the DRM components are first initialized prior to any guarantees of protection. - -

-
 
-Note  This enumeration value is supported starting with Windows 10. +
    +
  • + This flag cannot be used with the following D3D11_USAGE values:
      +
    • + D3D11_USAGE_DYNAMIC +
      • +
    • + D3D11_USAGE_STAGING +
      • +
    +
    • +
  • + This flag cannot be used with the following D3D11_BIND_FLAG values.
      +
    • + D3D11_BIND_VERTEX_BUFFER +
      • +
    • + D3D11_BIND_INDEX_BUFFER +
      • +
    +
    • +
  • No CPU access flags can be specified.
    • +
+
+ Note  

Creating a texture using this flag does not automatically guarantee that hardware protection will be enabled for the underlying allocation. Some implementations require that the DRM components are first initialized prior to any guarantees of protection.

+
+
 
+ Note  This enumeration value is supported starting with Windows 10. + These flags identify the type of resource that will be viewed as a render target. - Microsoft Docs: + + Microsoft Docs: + - Do not use this value, as it will cause ID3D11Device::CreateRenderTargetView to fail. + + Do not use this value, as it will cause ID3D11Device::CreateRenderTargetView to fail. + The resource will be accessed as a buffer. @@ -4328,19 +5967,29 @@ This flag has the following restrictions: Queues commands from a command list onto a device. - Microsoft Docs: - A pointer to an ID3D11CommandList interface that encapsulates a command list. - A Boolean flag that determines whether the target context state is saved prior to and restored after the execution of a command list. Use TRUE to indicate that the runtime needs to save and restore the state. Use FALSE to indicate that no state shall be saved or restored, which causes the target context to return to its default state after the command list executes. Applications should typically use FALSE unless they will restore the state to be nearly equivalent to the state that the runtime would restore if TRUE were passed. When applications use FALSE, they can avoid unnecessary and inefficient state transitions. + + Microsoft Docs: + + + A pointer to an ID3D11CommandList interface that encapsulates a command list. + + + A Boolean flag that determines whether the target context state is saved prior to and restored after the execution of a command list. Use TRUE to indicate that the runtime needs to save and restore the state. Use FALSE to indicate that no state shall be saved or restored, which causes the target context to return to its default state after the command list executes. Applications should typically use FALSE unless they will restore the state to be nearly equivalent to the state that the runtime would restore if TRUE were passed. When applications use FALSE, they can avoid unnecessary and inefficient state transitions. + Contains input data for a D3D11_AUTHENTICATED_QUERY_OUTPUT_ID query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_INPUT structure that contains the GUID for the query and other data. + + A D3D11_AUTHENTICATED_QUERY_INPUT structure that contains the GUID for the query and other data. + A handle to the device. @@ -4351,213 +6000,295 @@ This flag has the following restrictions: The index of the output ID. - - - Copies tiles from buffer to tiled resource or vice versa. - Microsoft Docs: - A pointer to a tiled resource. - A pointer to a D3D11_TILED_RESOURCE_COORDINATE structure that describes the starting coordinates of the tiled resource. - A pointer to a D3D11_TILE_REGION_SIZE structure that describes the size of the tiled region. - A pointer to an ID3D11Buffer that represents a default, dynamic, or staging buffer. - The offset in bytes into the buffer at pBuffer to start the operation. - A combination of D3D11_TILE_COPY_FLAG-typed values that are combined by using a bitwise OR operation and that identifies how to copy tiles. - - Sets the destination rectangle for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + Specifies whether to apply the destination rectangle. - A pointer to a RECT structure that specifies the destination rectangle. If Enable is FALSE, this parameter is ignored. + + A pointer to a RECT structure that specifies the destination rectangle. If Enable is FALSE, this parameter is ignored. + Get the pixel shader resources. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin getting shader resources from (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). The number of resources to get from the device. Up to a maximum of 128 slots are available for shader resources (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to be returned by the device. + + Array of shader resource view interfaces to be returned by the device. + Updates tiles by copying from app memory to the tiled resource. - Microsoft Docs: + + Microsoft Docs: + A pointer to a tiled resource to update. - A pointer to a D3D11_TILED_RESOURCE_COORDINATE structure that describes the starting coordinates of the tiled resource. - A pointer to a D3D11_TILE_REGION_SIZE structure that describes the size of the tiled region. - A pointer to memory that contains the source tile data that UpdateTiles uses to update the tiled resource. - A combination of D3D11_TILE_COPY_FLAG-typed values that are combined by using a bitwise OR operation. The only valid value is D3D11_TILE_COPY_NO_OVERWRITE. - The other values aren't meaningful here, though -by definition the D3D11_TILE_COPY_LINEAR_BUFFER_TO_SWIZZLED_TILED_RESOURCE value is basically what UpdateTiles does, but sources from app memory. + + A pointer to a D3D11_TILED_RESOURCE_COORDINATE structure that describes the starting coordinates of the tiled resource. + + + A pointer to a D3D11_TILE_REGION_SIZE structure that describes the size of the tiled region. + + + A pointer to memory that contains the source tile data that UpdateTiles uses to update the tiled resource. + + + A combination of D3D11_TILE_COPY_FLAG-typed values that are combined by using a bitwise OR operation. The only valid value is D3D11_TILE_COPY_NO_OVERWRITE. + The other values aren't meaningful here, though + by definition the D3D11_TILE_COPY_LINEAR_BUFFER_TO_SWIZZLED_TILED_RESOURCE value is basically what UpdateTiles does, but sources from app memory. + Describes the subresources from a resource that are accessible using an unordered-access view. - Microsoft Docs: + + Microsoft Docs: + - A DXGI_FORMAT-typed value that specifies the data format. + + A DXGI_FORMAT-typed value that specifies the data format. + - A D3D11_UAV_DIMENSION-typed value that specifies the resource type of the view. This type is the same as the resource type of the underlying resource. This member also determines which _UAV to use in the union below. + + A D3D11_UAV_DIMENSION-typed value that specifies the resource type of the view. This type is the same as the resource type of the underlying resource. This member also determines which _UAV to use in the union below. + - A D3D11_BUFFER_UAV structure that specifies which buffer elements can be accessed. + + A D3D11_BUFFER_UAV structure that specifies which buffer elements can be accessed. + - A D3D11_TEX1D_UAV structure that specifies the subresources in a 1D texture that can be accessed. + + A D3D11_TEX1D_UAV structure that specifies the subresources in a 1D texture that can be accessed. + - A D3D11_TEX1D_ARRAY_UAV structure that specifies the subresources in a 1D texture array that can be accessed. + + A D3D11_TEX1D_ARRAY_UAV structure that specifies the subresources in a 1D texture array that can be accessed. + - A D3D11_TEX2D_UAV1 structure that specifies the subresources in a 2D texture that can be accessed. + + A D3D11_TEX2D_UAV1 structure that specifies the subresources in a 2D texture that can be accessed. + - A D3D11_TEX2D_ARRAY_UAV1 structure that specifies the subresources in a 2D texture array that can be accessed. + + A D3D11_TEX2D_ARRAY_UAV1 structure that specifies the subresources in a 2D texture array that can be accessed. + - A D3D11_TEX3D_UAV structure that specifies subresources in a 3D texture that can be accessed. + + A D3D11_TEX3D_UAV structure that specifies subresources in a 3D texture that can be accessed. + Get an input-parameter description for a shader. - Microsoft Docs: + + Microsoft Docs: + A zero-based parameter index. - A pointer to a shader-input-signature description. See D3D11_SIGNATURE_PARAMETER_DESC. + + A pointer to a shader-input-signature description. See D3D11_SIGNATURE_PARAMETER_DESC. + Describes the tile structure of a tiled resource with mipmaps. - Microsoft Docs: + + Microsoft Docs: + Number of standard mipmaps in the tiled resource. - Number of packed mipmaps in the tiled resource. + + Number of packed mipmaps in the tiled resource. -This number starts from the least detailed mipmap (either sharing tiles or using non standard tile layout). This number is 0 if no -such packing is in the resource. For array surfaces, this value is the number of mipmaps that are packed for a given array slice where each array slice repeats the same -packing. + This number starts from the least detailed mipmap (either sharing tiles or using non standard tile layout). This number is 0 if no + such packing is in the resource. For array surfaces, this value is the number of mipmaps that are packed for a given array slice where each array slice repeats the same + packing. -On Tier_2 tiled resources hardware, mipmaps that fill at least one standard shaped tile in all dimensions -are not allowed to be included in the set of packed mipmaps. On Tier_1 hardware, mipmaps that are an integer multiple of one standard shaped tile in all dimensions are not allowed to be included in the set of packed mipmaps. Mipmaps with at least one -dimension less than the standard tile shape may or may not be packed. When a given mipmap needs to be packed, all coarser -mipmaps for a given array slice are considered packed as well. + On Tier_2 tiled resources hardware, mipmaps that fill at least one standard shaped tile in all dimensions + are not allowed to be included in the set of packed mipmaps. On Tier_1 hardware, mipmaps that are an integer multiple of one standard shaped tile in all dimensions are not allowed to be included in the set of packed mipmaps. Mipmaps with at least one + dimension less than the standard tile shape may or may not be packed. When a given mipmap needs to be packed, all coarser + mipmaps for a given array slice are considered packed as well. + - Number of tiles for the packed mipmaps in the tiled resource. + + Number of tiles for the packed mipmaps in the tiled resource. -If there is no packing, this value is meaningless and is set to 0. -Otherwise, it is set to the number of tiles -that are needed to represent the set of packed mipmaps. -The pixel layout within the packed mipmaps is hardware specific. -If apps define only partial mappings for the set of tiles in packed mipmaps, read and write behavior is vendor specific and undefined. -For arrays, this value is only the count of packed mipmaps within -the subresources for each array slice. + If there is no packing, this value is meaningless and is set to 0. + Otherwise, it is set to the number of tiles + that are needed to represent the set of packed mipmaps. + The pixel layout within the packed mipmaps is hardware specific. + If apps define only partial mappings for the set of tiles in packed mipmaps, read and write behavior is vendor specific and undefined. + For arrays, this value is only the count of packed mipmaps within + the subresources for each array slice. + - Offset of the first packed tile for the resource -in the overall range of tiles. If NumPackedMips is 0, this -value is meaningless and is 0. Otherwise, it is the -offset of the first packed tile for the resource in the overall -range of tiles for the resource. A value of 0 for -StartTileIndexInOverallResource means the entire resource is packed. -For array surfaces, this is the offset for the tiles that contain the packed -mipmaps for the first array slice. Packed mipmaps for each array slice in arrayed surfaces are at this offset -past the beginning of the tiles for each array slice. + + Offset of the first packed tile for the resource + in the overall range of tiles. If NumPackedMips is 0, this + value is meaningless and is 0. Otherwise, it is the + offset of the first packed tile for the resource in the overall + range of tiles for the resource. A value of 0 for + StartTileIndexInOverallResource means the entire resource is packed. + For array surfaces, this is the offset for the tiles that contain the packed + mipmaps for the first array slice. Packed mipmaps for each array slice in arrayed surfaces are at this offset + past the beginning of the tiles for each array slice. -
Note  The -number of overall tiles, packed or not, for a given array slice is -simply the total number of tiles for the resource divided by the -resource's array size, so it is easy to locate the range of tiles for -any given array slice, out of which StartTileIndexInOverallResource identifies -which of those are packed.
-
 
 +
+ Note  The + number of overall tiles, packed or not, for a given array slice is + simply the total number of tiles for the resource divided by the + resource's array size, so it is easy to locate the range of tiles for + any given array slice, out of which StartTileIndexInOverallResource identifies + which of those are packed. +
+
 
+ Sets the rate at which the video processor produces output frames for an input stream. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - The output rate, specified as a D3D11_VIDEO_PROCESSOR_OUTPUT_RATE value. - Specifies how the driver performs frame-rate conversion, if required. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + The output rate, specified as a D3D11_VIDEO_PROCESSOR_OUTPUT_RATE value. + + + Specifies how the driver performs frame-rate conversion, if required. - - - - - - - - + +
ValueMeaning
-
TRUE
-
-		 -Repeat frames. + + + + + + + + - - - - + + + + - -
ValueMeaning
+ + +
+
+ TRUE +
+
+ 		+ Repeat frames. -
-
FALSE
-
-		 -Interpolate frames. +
+ + +
+
+ FALSE +
+
+ 		+ Interpolate frames. -
- A pointer to a DXGI_RATIONAL structure. If OutputRate is D3D11_VIDEO_PROCESSOR_OUTPUT_RATE_CUSTOM, this parameter specifies the exact output rate. Otherwise, this parameter is ignored and can be NULL. +
+ + + A pointer to a DXGI_RATIONAL structure. If OutputRate is D3D11_VIDEO_PROCESSOR_OUTPUT_RATE_CUSTOM, this parameter specifies the exact output rate. Otherwise, this parameter is ignored and can be NULL. + Clear all messages from the message queue. - Microsoft Docs: + + Microsoft Docs: + Sets the constant buffers that the vertex shader pipeline stage uses. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + Array of constant buffers being given to the device. - An array that holds the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. Each offset must be a multiple of 16 constants. - An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + + An array that holds the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. Each offset must be a multiple of 16 constants. + + + An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + Copies data into a D3D11_USAGE_DEFAULTtexture which was mapped using ID3D11DeviceContext3::Mapwhile providing a NULL D3D11_MAPPED_SUBRESOURCEparameter. - Microsoft Docs: - A pointer to the destination resource (an - ID3D11Resource). - A zero-based index, that identifies the destination subresource. - For more details, see - D3D11CalcSubresource. - A pointer to a box that defines the portion of the destination subresource to copy the resource data into. - If NULL, the data is written to the destination subresource with no offset. - The dimensions of the source must fit the destination (see - D3D11_BOX). - + + Microsoft Docs: + + + A pointer to the destination resource (an + ID3D11Resource). + + + A zero-based index, that identifies the destination subresource. + For more details, see + D3D11CalcSubresource. + + + A pointer to a box that defines the portion of the destination subresource to copy the resource data into. + If NULL, the data is written to the destination subresource with no offset. + The dimensions of the source must fit the destination (see + D3D11_BOX). -An empty box results in a no-op. - A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. - When the box is empty, this method doesn't perform any operation. + + An empty box results in a no-op. + A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. + When the box is empty, this method doesn't perform any operation. + A pointer to the source data in memory. The size of one row of the source data. The size of one depth slice of source data. @@ -4566,45 +6297,77 @@ An empty box results in a no-op. Sets the pixel aspect ratio for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Specifies whether the pSourceAspectRatio and pDestinationAspectRatio parameters contain valid values. Otherwise, the pixel aspect ratios are unspecified. - A pointer to a DXGI_RATIONAL structure that contains the pixel aspect ratio of the source rectangle. If Enable is FALSE, this parameter can be NULL. - A pointer to a DXGI_RATIONAL structure that contains the pixel aspect ratio of the destination rectangle. If Enable is FALSE, this parameter can be NULL. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Specifies whether the pSourceAspectRatio and pDestinationAspectRatio parameters contain valid values. Otherwise, the pixel aspect ratios are unspecified. + + + A pointer to a DXGI_RATIONAL structure that contains the pixel aspect ratio of the source rectangle. If Enable is FALSE, this parameter can be NULL. + + + A pointer to a DXGI_RATIONAL structure that contains the pixel aspect ratio of the destination rectangle. If Enable is FALSE, this parameter can be NULL. + Set data to a device and associate that data with a guid. - Microsoft Docs: + + Microsoft Docs: + Guid associated with the data. Size of the data. - Pointer to the data to be stored with this device. If pData is NULL, DataSize must also be 0, and any data previously associated with the guid will be destroyed. + + Pointer to the data to be stored with this device. If pData is NULL, DataSize must also be 0, and any data previously associated with the guid will be destroyed. + A hull-shader interface manages an executable program (a hull shader) that controls the hull-shader stage. - Microsoft Docs: + + Microsoft Docs: + Gets the current background color for the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - Receives the value TRUE if the background color is a YCbCr color, or FALSE if the background color is an RGB color. - A pointer to a D3D11_VIDEO_COLOR structure. The method fills in the structure with the background color. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + Receives the value TRUE if the background color is a YCbCr color, or FALSE if the background color is an RGB color. + + + A pointer to a D3D11_VIDEO_COLOR structure. The method fills in the structure with the background color. + Get the vertex buffers bound to the input-assembler stage. - Microsoft Docs: - The input slot of the first vertex buffer to get. The first vertex buffer is explicitly bound to the start slot; this causes each additional vertex buffer in the array to be implicitly bound to each subsequent input slot. The maximum of 16 or 32 input slots (ranges from 0 to D3D11_IA_VERTEX_INPUT_RESOURCE_SLOT_COUNT - 1) are available; the maximum number of input slots depends on the feature level. + + Microsoft Docs: + + + The input slot of the first vertex buffer to get. The first vertex buffer is explicitly bound to the start slot; this causes each additional vertex buffer in the array to be implicitly bound to each subsequent input slot. The maximum of 16 or 32 input slots (ranges from 0 to D3D11_IA_VERTEX_INPUT_RESOURCE_SLOT_COUNT - 1) are available; the maximum number of input slots depends on the feature level. + The number of vertex buffers to get starting at the offset. The number of buffers (plus the starting slot) cannot exceed the total number of IA-stage input slots. - A pointer to an array of vertex buffers returned by the method (see ID3D11Buffer). + + A pointer to an array of vertex buffers returned by the method (see ID3D11Buffer). + Pointer to an array of stride values returned by the method; one stride value for each buffer in the vertex-buffer array. Each stride value is the size (in bytes) of the elements that are to be used from that vertex buffer. Pointer to an array of offset values returned by the method; one offset value for each buffer in the vertex-buffer array. Each offset is the number of bytes between the first element of a vertex buffer and the first element that will be used. @@ -4612,61 +6375,95 @@ An empty box results in a no-op. Specifies a data access ordering constraint between multiple tiled resources. - Microsoft Docs: - A pointer to an ID3D11Resource or ID3D11View for a resource that was created with the D3D11_RESOURCE_MISC_TILED flag. Access operations on this object must complete before the access operations on the object that pTiledResourceOrViewAccessAfterBarrier specifies. - A pointer to an ID3D11Resource or ID3D11View for a resource that was created with the D3D11_RESOURCE_MISC_TILED flag. Access operations on this object must begin after the access operations on the object that pTiledResourceOrViewAccessBeforeBarrier specifies. + + Microsoft Docs: + + + A pointer to an ID3D11Resource or ID3D11View for a resource that was created with the D3D11_RESOURCE_MISC_TILED flag. Access operations on this object must complete before the access operations on the object that pTiledResourceOrViewAccessAfterBarrier specifies. + + + A pointer to an ID3D11Resource or ID3D11View for a resource that was created with the D3D11_RESOURCE_MISC_TILED flag. Access operations on this object must begin after the access operations on the object that pTiledResourceOrViewAccessBeforeBarrier specifies. + Set an array of sampler states to the pixel shader pipeline stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting samplers to (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers in the array. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + + Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + Copies mappings from a source tiled resource to a destination tiled resource. - Microsoft Docs: + + Microsoft Docs: + A pointer to the destination tiled resource. - A pointer to a D3D11_TILED_RESOURCE_COORDINATE structure that describes the starting coordinates of the destination tiled resource. + + A pointer to a D3D11_TILED_RESOURCE_COORDINATE structure that describes the starting coordinates of the destination tiled resource. + A pointer to the source tiled resource. - A pointer to a D3D11_TILED_RESOURCE_COORDINATE structure that describes the starting coordinates of the source tiled resource. - A pointer to a D3D11_TILE_REGION_SIZE structure that describes the size of the tiled region. - A combination of D3D11_TILE_MAPPING_FLAGS values that are combined by using a bitwise OR operation. The only valid value is D3D11_TILE_MAPPING_NO_OVERWRITE, which indicates that previously submitted commands to the device that may still be executing do not reference any of the tile region being updated. The device can then avoid having to flush previously submitted work to perform the tile mapping update. If the app violates this promise by updating tile mappings for locations in tiled resources that are still being referenced by outstanding commands, undefined rendering behavior results, including the potential for significant slowdowns on some architectures. This is like the "no overwrite" concept that exists elsewhere in the Direct3D API, except applied to the tile mapping data structure itself (which in hardware is a page table). The absence of the D3D11_TILE_MAPPING_NO_OVERWRITE value requires that tile mapping updates that CopyTileMappings specifies must be completed before any subsequent Direct3D command can proceed. + + A pointer to a D3D11_TILED_RESOURCE_COORDINATE structure that describes the starting coordinates of the source tiled resource. + + + A pointer to a D3D11_TILE_REGION_SIZE structure that describes the size of the tiled region. + + + A combination of D3D11_TILE_MAPPING_FLAGS values that are combined by using a bitwise OR operation. The only valid value is D3D11_TILE_MAPPING_NO_OVERWRITE, which indicates that previously submitted commands to the device that may still be executing do not reference any of the tile region being updated. The device can then avoid having to flush previously submitted work to perform the tile mapping update. If the app violates this promise by updating tile mappings for locations in tiled resources that are still being referenced by outstanding commands, undefined rendering behavior results, including the potential for significant slowdowns on some architectures. This is like the "no overwrite" concept that exists elsewhere in the Direct3D API, except applied to the tile mapping data structure itself (which in hardware is a page table). The absence of the D3D11_TILE_MAPPING_NO_OVERWRITE value requires that tile mapping updates that CopyTileMappings specifies must be completed before any subsequent Direct3D command can proceed. + A function-linking-graph interface is used for constructing shaders that consist of a sequence of precompiled function calls that pass values to each other. - Microsoft Docs: + + Microsoft Docs: + Get an array of sampler state interfaces from the hull-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into a zero-based array to begin getting samplers from (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers to get from a device context. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). + + Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). + Gets private state data from the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + A pointer to a GUID that identifies the state. The meaning of this GUID is defined by the graphics driver. - The size of the pData buffer, in bytes. + + The size of the pData buffer, in bytes. + A pointer to a buffer that receives the private state data. Specifies a type of compressed buffer for decoding. - Microsoft Docs: + + Microsoft Docs: + @@ -4699,163 +6496,239 @@ An empty box results in a no-op. Get a description of the resource. - Microsoft Docs: - Pointer to a resource description (see D3D11_UNORDERED_ACCESS_VIEW_DESC.) + + Microsoft Docs: + + + Pointer to a resource description (see D3D11_UNORDERED_ACCESS_VIEW_DESC.) + Specifies the intended use for a video processor. - Microsoft Docs: + + Microsoft Docs: + Normal video playback. The graphics driver should expose a set of capabilities that are appropriate for real-time video playback. - Optimal speed. The graphics driver should expose a minimal set of capabilities that are optimized for performance. + + Optimal speed. The graphics driver should expose a minimal set of capabilities that are optimized for performance. -Use this setting if you want better performance and can accept some reduction in video quality. For example, you might use this setting in power-saving mode or to play video thumbnails. + Use this setting if you want better performance and can accept some reduction in video quality. For example, you might use this setting in power-saving mode or to play video thumbnails. + - Optimal quality. The grahics driver should expose its maximum set of capabilities. + + Optimal quality. The grahics driver should expose its maximum set of capabilities. -Specify this setting to get the best video quality possible. It is appropriate for tasks such as video editing, when quality is more important than speed. It is not appropriate for real-time playback. + Specify this setting to get the best video quality possible. It is appropriate for tasks such as video editing, when quality is more important than speed. It is not appropriate for real-time playback. + Push a copy of retrieval filter currently on the top of the retrieval-filter stack onto the retrieval-filter stack. - Microsoft Docs: + + Microsoft Docs: + Copies data from a D3D11_USAGE_DEFAULTtexture which was mapped using ID3D11DeviceContext3::Mapwhile providing a NULL D3D11_MAPPED_SUBRESOURCEparameter. - Microsoft Docs: + + Microsoft Docs: + A pointer to the destination data in memory. The size of one row of the destination data. The size of one depth slice of destination data. - A pointer to the source resource (see - ID3D11Resource). - A zero-based index, that identifies the destination subresource. - For more details, see - D3D11CalcSubresource. - A pointer to a box that defines the portion of the destination subresource to copy the resource data from. - If NULL, the data is read from the destination subresource with no offset. - The dimensions of the destination must fit the destination (see - D3D11_BOX). - + + A pointer to the source resource (see + ID3D11Resource). + + + A zero-based index, that identifies the destination subresource. + For more details, see + D3D11CalcSubresource. + + + A pointer to a box that defines the portion of the destination subresource to copy the resource data from. + If NULL, the data is read from the destination subresource with no offset. + The dimensions of the destination must fit the destination (see + D3D11_BOX). -An empty box results in a no-op. - A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. - When the box is empty, this method doesn't perform any operation. + + An empty box results in a no-op. + A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. + When the box is empty, this method doesn't perform any operation. + Describes a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + - A DXGI_FORMAT-typed value that specifies the viewing format. See remarks. + + A DXGI_FORMAT-typed value that specifies the viewing format. See remarks. + - A D3D11_SRV_DIMENSION-typed value that specifies the resource type of the view. This type is the same as the resource type of the underlying resource. This member also determines which _SRV to use in the union below. + + A D3D11_SRV_DIMENSION-typed value that specifies the resource type of the view. This type is the same as the resource type of the underlying resource. This member also determines which _SRV to use in the union below. + - A D3D11_BUFFER_SRV structure that views the resource as a buffer. + + A D3D11_BUFFER_SRV structure that views the resource as a buffer. + - A D3D11_TEX1D_SRV structure that views the resource as a 1D texture. + + A D3D11_TEX1D_SRV structure that views the resource as a 1D texture. + - A D3D11_TEX1D_ARRAY_SRV structure that views the resource as a 1D-texture array. + + A D3D11_TEX1D_ARRAY_SRV structure that views the resource as a 1D-texture array. + - A D3D11_TEX2D_SRV1 structure that views the resource as a 2D-texture. + + A D3D11_TEX2D_SRV1 structure that views the resource as a 2D-texture. + - A D3D11_TEX2D_ARRAY_SRV1 structure that views the resource as a 2D-texture array. + + A D3D11_TEX2D_ARRAY_SRV1 structure that views the resource as a 2D-texture array. + - A D3D11_TEX2DMS_SRV structure that views the resource as a 2D-multisampled texture. + + A D3D11_TEX2DMS_SRV structure that views the resource as a 2D-multisampled texture. + - A D3D11_TEX2DMS_ARRAY_SRV structure that views the resource as a 2D-multisampled-texture array. + + A D3D11_TEX2DMS_ARRAY_SRV structure that views the resource as a 2D-multisampled-texture array. + - A D3D11_TEX3D_SRV structure that views the resource as a 3D texture. + + A D3D11_TEX3D_SRV structure that views the resource as a 3D texture. + - A D3D11_TEXCUBE_SRV structure that views the resource as a 3D-cube texture. + + A D3D11_TEXCUBE_SRV structure that views the resource as a 3D-cube texture. + - A D3D11_TEXCUBE_ARRAY_SRV structure that views the resource as a 3D-cube-texture array. + + A D3D11_TEXCUBE_ARRAY_SRV structure that views the resource as a 3D-cube-texture array. + - A D3D11_BUFFEREX_SRV structure that views the resource as a raw buffer. For more info about raw viewing of buffers, see Raw Views of Buffers. + + A D3D11_BUFFEREX_SRV structure that views the resource as a raw buffer. For more info about raw viewing of buffers, see Raw Views of Buffers. + Gets the number of Mov instructions. - Microsoft Docs: + + Microsoft Docs: + Gets the size of the driver's certificate chain. - Microsoft Docs: + + Microsoft Docs: + Receives the size of the certificate chain, in bytes. Describes Direct3D 9 shadow support in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether the driver supports the shadowing feature with the comparison-filtering mode set to less than or equal to. The runtime sets this member to TRUE for hardware at Direct3D 10 and higher feature levels. For hardware at Direct3D 9.3 and lower feature levels, the runtime sets this member to TRUE only if the hardware and driver support the shadowing feature; otherwise FALSE. + + Specifies whether the driver supports the shadowing feature with the comparison-filtering mode set to less than or equal to. The runtime sets this member to TRUE for hardware at Direct3D 10 and higher feature levels. For hardware at Direct3D 9.3 and lower feature levels, the runtime sets this member to TRUE only if the hardware and driver support the shadowing feature; otherwise FALSE. + The rasterizer-state interface holds a description for rasterizer state that you can bind to the rasterizer stage. - Microsoft Docs: + + Microsoft Docs: + Categories of debug messages. - Microsoft Docs: + + Microsoft Docs: + - User defined message. See ID3D11InfoQueue::AddMessage. + + User defined message. See ID3D11InfoQueue::AddMessage. + - Direct3D 11:  This value is not supported until Direct3D 11.1. + + Direct3D 11:  This value is not supported until Direct3D 11.1. + Gets the planar alpha for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Receives the value TRUE if planar alpha is enabled, or FALSE otherwise. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Receives the value TRUE if planar alpha is enabled, or FALSE otherwise. + Receives the planar alpha value. The value can range from 0.0 (transparent) to 1.0 (opaque). Contains input data for a D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_COUNT query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_INPUT structure that contains the GUID for the query and other data. + + A D3D11_AUTHENTICATED_QUERY_INPUT structure that contains the GUID for the query and other data. + A handle to the device. @@ -4866,37 +6739,57 @@ An empty box results in a no-op. A depth-stencil-view interface accesses a texture resource during depth-stencil testing. - Microsoft Docs: + + Microsoft Docs: + Get a constant buffer by index. - Microsoft Docs: + + Microsoft Docs: + Zero-based index. Creates a resource view for a video processor, describing the input sample for the video processing operation. - Microsoft Docs: - A pointer to the ID3D11Resource interface of the input surface. - A pointer to the ID3D11VideoProcessorEnumerator interface that specifies the video processor. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessorEnumerator. - A pointer to a D3D11_VIDEO_PROCESSOR_INPUT_VIEW_DESC structure that describes the view. - Receives a pointer to the ID3D11VideoProcessorInputView interface. The caller must release the resource. If this parameter is NULL, the method checks whether the view is supported, but does not create the view. + + Microsoft Docs: + + + A pointer to the ID3D11Resource interface of the input surface. + + + A pointer to the ID3D11VideoProcessorEnumerator interface that specifies the video processor. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessorEnumerator. + + + A pointer to a D3D11_VIDEO_PROCESSOR_INPUT_VIEW_DESC structure that describes the view. + + + Receives a pointer to the ID3D11VideoProcessorInputView interface. The caller must release the resource. If this parameter is NULL, the method checks whether the view is supported, but does not create the view. + Describes a shader-variable type. - Microsoft Docs: + + Microsoft Docs: + - A D3D_SHADER_VARIABLE_CLASS-typed value that identifies the variable class as one of scalar, vector, matrix, object, and so on. + + A D3D_SHADER_VARIABLE_CLASS-typed value that identifies the variable class as one of scalar, vector, matrix, object, and so on. + - A D3D_SHADER_VARIABLE_TYPE-typed value that identifies the variable type. + + A D3D_SHADER_VARIABLE_TYPE-typed value that identifies the variable type. + Number of rows in a matrix. Otherwise a numeric type returns 1, any other type returns 0. @@ -4914,76 +6807,108 @@ An empty box results in a no-op. Offset, in bytes, between the start of the parent structure and this variable. Can be 0 if not a structure member. - Name of the shader-variable type. This member can be NULL if it isn't used. This member supports dynamic shader linkage interface types, which have names. For more info about dynamic shader linkage, see Dynamic Linking. + + Name of the shader-variable type. This member can be NULL if it isn't used. This member supports dynamic shader linkage interface types, which have names. For more info about dynamic shader linkage, see Dynamic Linking. + Specifies the subresource from a 1D texture to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + - Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original Texture1D for which ID3D11Device::CreateShaderResourceView creates a view) -1. + + Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original Texture1D for which ID3D11Device::CreateShaderResourceView creates a view) -1. + - The maximum number of mipmap levels for the view of the texture. See the remarks. + + The maximum number of mipmap levels for the view of the texture. See the remarks. -Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + A compute-shader interface manages an executable program (a compute shader) that controls the compute-shader stage. - Microsoft Docs: + + Microsoft Docs: + Sets the output color space for the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - A pointer to a D3D11_VIDEO_PROCESSOR_COLOR_SPACE structure that specifies the color space. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + A pointer to a D3D11_VIDEO_PROCESSOR_COLOR_SPACE structure that specifies the color space. + The rasterizer-state interface holds a description for rasterizer state that you can bind to the rasterizer stage. This rasterizer-state interface supports forced sample count. - Microsoft Docs: + + Microsoft Docs: + Get the constant buffers used by the vertex shader pipeline stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + + Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + This interface encapsulates methods for measuring GPU performance. - Microsoft Docs: + + Microsoft Docs: + Sends queued-up commands in the command buffer to the graphics processing unit (GPU), with a specified context type and an optional event handle to create an event query. - Microsoft Docs: - A D3D11_CONTEXT_TYPE that specifies the context in which a query occurs, such as a 3D command queue, 3D compute queue, 3D copy queue, video, or image. - An optional event handle. When specified, this method creates an event query. - + + Microsoft Docs: + + + A D3D11_CONTEXT_TYPE that specifies the context in which a query occurs, such as a 3D command queue, 3D compute queue, 3D copy queue, video, or image. + + + An optional event handle. When specified, this method creates an event query. -Flush1 operates asynchronously, therefore it can return either before or after the GPU finishes executing the queued graphics commands, which will eventually complete. - To create an event query, you can call ID3D11Device::CreateQuery with the - value D3D11_QUERY_EVENT value. - To determine when the GPU is finished processing the graphics commands, - you can then use that event query in a call to ID3D11DeviceContext::GetData. + + Flush1 operates asynchronously, therefore it can return either before or after the GPU finishes executing the queued graphics commands, which will eventually complete. + To create an event query, you can call ID3D11Device::CreateQuery with the + value D3D11_QUERY_EVENT value. + To determine when the GPU is finished processing the graphics commands, + you can then use that event query in a call to ID3D11DeviceContext::GetData. + Option(s) for raising an error to a non-continuable exception. - Microsoft Docs: + + Microsoft Docs: + @@ -4992,17 +6917,23 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Represents key exchange data for hardware content protection. - Microsoft Docs: + + Microsoft Docs: + The function ID of the DRM command. The values and meanings of the function ID are defined by the DRM specification. - Pointer to a buffer containing a D3D11_KEY_EXCHANGE_HW_PROTECTION_INPUT_DATA structure that specifies memory reserved for IHV use and the input data for the DRM command. + + Pointer to a buffer containing a D3D11_KEY_EXCHANGE_HW_PROTECTION_INPUT_DATA structure that specifies memory reserved for IHV use and the input data for the DRM command. + - Pointer to a buffer containing a D3D11_KEY_EXCHANGE_HW_PROTECTION_OUTPUT_DATA structure that specifies memory reserved for IHV use and the input data for the DRM command. + + Pointer to a buffer containing a D3D11_KEY_EXCHANGE_HW_PROTECTION_OUTPUT_DATA structure that specifies memory reserved for IHV use and the input data for the DRM command. + The result of the hardware DRM command. @@ -5010,16 +6941,24 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Get the blend state of the output-merger stage. - Microsoft Docs: - Address of a pointer to a blend-state interface (see ID3D11BlendState). + + Microsoft Docs: + + + Address of a pointer to a blend-state interface (see ID3D11BlendState). + Array of blend factors, one for each RGBA component. - Pointer to a sample mask. + + Pointer to a sample mask. + Arguments for draw indexed instanced indirect. - Microsoft Docs: + + Microsoft Docs: + @@ -5040,7 +6979,9 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Specifies logical operations to configure for a render target. - Microsoft Docs: + + Microsoft Docs: + @@ -5094,30 +7035,46 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Gets the number of conversion instructions. - Microsoft Docs: + + Microsoft Docs: + Activates the given context state object and changes the current device behavior to Direct3D 11, Direct3D 10.1, or Direct3D 10. - Microsoft Docs: - A pointer to the ID3DDeviceContextState interface for the context state object that was previously created through the ID3D11Device1::CreateDeviceContextState method. If SwapDeviceContextState is called with pState set to NULL, the call has no effect. - A pointer to a variable that receives a pointer to the ID3DDeviceContextState interface for the previously-activated context state object. + + Microsoft Docs: + + + A pointer to the ID3DDeviceContextState interface for the context state object that was previously created through the ID3D11Device1::CreateDeviceContextState method. If SwapDeviceContextState is called with pState set to NULL, the call has no effect. + + + A pointer to a variable that receives a pointer to the ID3DDeviceContextState interface for the previously-activated context state object. + Set a geometry shader to the device. - Microsoft Docs: - Pointer to a geometry shader (see ID3D11GeometryShader). Passing in NULL disables the shader for this pipeline stage. - A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + + Microsoft Docs: + + + Pointer to a geometry shader (see ID3D11GeometryShader). Passing in NULL disables the shader for this pipeline stage. + + + A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + The number of class-instance interfaces in the array. Specifies the subresource from a 1D texture that is accessible to a depth-stencil view. - Microsoft Docs: + + Microsoft Docs: + @@ -5126,257 +7083,360 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Get a pointer to the input-layout object that is bound to the input-assembler stage. - Microsoft Docs: - A pointer to the input-layout object (see ID3D11InputLayout), which describes the input buffers that will be read by the IA stage. + + Microsoft Docs: + + + A pointer to the input-layout object (see ID3D11InputLayout), which describes the input buffers that will be read by the IA stage. + Returns driver hints that indicate which of the video processor operations are best performed using multi-plane overlay hardware rather than ID3D11VideoContext::VideoProcessorBlt method. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + The width of the output stream. The height of the output stream. The format of the output stream. The number of input streams to process. An array of structures that specifies the format of each input stream and whether each stream should be used when computing behavior hints. - A pointer to a bitwise OR combination of D3D11_VIDEO_PROCESSOR_BEHAVIOR_HINTS values indicating which video processor operations would best be performed using multi-plane overlay hardware rather than the ID3D11VideoContext::VideoProcessorBlt method. + + A pointer to a bitwise OR combination of D3D11_VIDEO_PROCESSOR_BEHAVIOR_HINTS values indicating which video processor operations would best be performed using multi-plane overlay hardware rather than the ID3D11VideoContext::VideoProcessorBlt method. + The device interface represents a virtual adapter; it is used to create resources. ID3D11Device2 adds new methods to those in ID3D11Device1. - Microsoft Docs: + + Microsoft Docs: + Sends a configuration command to an authenticated channel. - Microsoft Docs: - A pointer to the ID3D11AuthenticatedChannel interface. - The size of the pInput array, in bytes. - A pointer to a byte array that contains input data for the command. This buffer always starts with a D3D11_AUTHENTICATED_CONFIGURE_INPUT structure. The ConfigureType member of the structure specifies the command and defines the meaning of the rest of the buffer. - A pointer to a D3D11_AUTHENTICATED_CONFIGURE_OUTPUT structure that receives the response to the command. + + Microsoft Docs: + + + A pointer to the ID3D11AuthenticatedChannel interface. + + + The size of the pInput array, in bytes. + + + A pointer to a byte array that contains input data for the command. This buffer always starts with a D3D11_AUTHENTICATED_CONFIGURE_INPUT structure. The ConfigureType member of the structure specifies the command and defines the meaning of the rest of the buffer. + + + A pointer to a D3D11_AUTHENTICATED_CONFIGURE_OUTPUT structure that receives the response to the command. + Bind an array of viewports to the rasterizer stage of the pipeline. - Microsoft Docs: + + Microsoft Docs: + Number of viewports to bind. - An array of D3D11_VIEWPORT structures to bind to the device. See the structure page for details about how the viewport size is dependent on the device feature level which has changed between Direct3D 11 and Direct3D 10. + + An array of D3D11_VIEWPORT structures to bind to the device. See the structure page for details about how the viewport size is dependent on the device feature level which has changed between Direct3D 11 and Direct3D 10. + Creates a rasterizer state object that informs the rasterizer stage how to behave and forces the sample count while UAV rendering or rasterizing. - Microsoft Docs: - A pointer to a D3D11_RASTERIZER_DESC1 structure that describes the rasterizer state. - Address of a pointer to the ID3D11RasterizerState1 interface for the rasterizer state object created. + + Microsoft Docs: + + + A pointer to a D3D11_RASTERIZER_DESC1 structure that describes the rasterizer state. + + + Address of a pointer to the ID3D11RasterizerState1 interface for the rasterizer state object created. + Contains input data for the ID3D11VideoContext::QueryAuthenticatedChannel method. - Microsoft Docs: + + Microsoft Docs: + - A GUID that specifies the query. The following GUIDs are defined. + + A GUID that specifies the query. The following GUIDs are defined. - - - - - - - - + +
ValueMeaning
-
D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_ATTRIBUTES
-
-		 -Returns the type of I/O bus that is used to send data to the GPU. + + + + + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - -
ValueMeaning
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_ATTRIBUTES +
+
+ 		+ Returns the type of I/O bus that is used to send data to the GPU. -Output data structure: D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_CHANNEL_TYPE
-
-		 -Returns the type of authenticated channel. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_CHANNEL_TYPE +
+
+ 		+ Returns the type of authenticated channel. -Output data structure: D3D11_AUTHENTICATED_QUERY_CHANNEL_TYPE_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_CHANNEL_TYPE_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_CRYPTO_SESSION
-
-		 -Returns handles to the cryptographic session and Direct3D device that are associated with a specified decoder device. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_CRYPTO_SESSION +
+
+ 		+ Returns handles to the cryptographic session and Direct3D device that are associated with a specified decoder device. -Input data structure: D3D11_AUTHENTICATED_QUERY_CRYPTO_SESSION_INPUT + Input data structure: D3D11_AUTHENTICATED_QUERY_CRYPTO_SESSION_INPUT -Output data structure: D3D11_AUTHENTICATED_QUERY_CRYPTO_SESSION_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_CRYPTO_SESSION_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_CURRENT_ENCRYPTION_WHEN_ACCESSIBLE
-
-		 -Returns the encryption type that is applied before content becomes accessible to the CPU or bus. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_CURRENT_ENCRYPTION_WHEN_ACCESSIBLE +
+
+ 		+ Returns the encryption type that is applied before content becomes accessible to the CPU or bus. -Output data structure: D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_ENCRYPTION_GUID_COUNT_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_ENCRYPTION_GUID_COUNT_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_DEVICE_HANDLE
-
-		 -Returns a handle to the device that is associated with this authenticated channel. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_DEVICE_HANDLE +
+
+ 		+ Returns a handle to the device that is associated with this authenticated channel. -Output data structure: D3D11_AUTHENTICATED_QUERY_DEVICE_HANDLE_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_DEVICE_HANDLE_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_ENCRYPTION_WHEN_ACCESSIBLE_GUID
-
-		 -Returns one of the encryption types that can be used to encrypt content before it becomes accessible to the CPU or bus. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_ENCRYPTION_WHEN_ACCESSIBLE_GUID +
+
+ 		+ Returns one of the encryption types that can be used to encrypt content before it becomes accessible to the CPU or bus. -Input data structure: D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_ENCRYPTION_GUID_INPUT + Input data structure: D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_ENCRYPTION_GUID_INPUT -Output data structure: D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_ENCRYPTION_GUID_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_ENCRYPTION_GUID_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_ENCRYPTION_WHEN_ACCESSIBLE_GUID_COUNT
-
-		 -Returns the number of encryption types that can be used to encrypt content before it becomes accessible to the CPU or bus. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_ENCRYPTION_WHEN_ACCESSIBLE_GUID_COUNT +
+
+ 		+ Returns the number of encryption types that can be used to encrypt content before it becomes accessible to the CPU or bus. -Output data structure: D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_ENCRYPTION_GUID_COUNT_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_ENCRYPTION_GUID_COUNT_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_OUTPUT_ID
-
-		 -Returns one of the output identifiers that is associated with a specified cryptographic session and Direct3D device. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_OUTPUT_ID +
+
+ 		+ Returns one of the output identifiers that is associated with a specified cryptographic session and Direct3D device. -Input data structure: D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_INPUT + Input data structure: D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_INPUT -Output data structure: D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_COUNT
-
-		 -Returns the number of output identifiers that are associated with a specified cryptographic session and Direct3D device. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_COUNT +
+
+ 		+ Returns the number of output identifiers that are associated with a specified cryptographic session and Direct3D device. -Input data structure: D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_COUNT_INPUT + Input data structure: D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_COUNT_INPUT -Output data structure: D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_COUNT_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_COUNT_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_PROTECTION
-
-		 -Returns the current protection level for the device. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_PROTECTION +
+
+ 		+ Returns the current protection level for the device. -Output data structure: D3D11_AUTHENTICATED_QUERY_PROTECTION_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_PROTECTION_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS
-
-		 -Returns information about a process that is allowed to open shared resources with restricted access. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS +
+
+ 		+ Returns information about a process that is allowed to open shared resources with restricted access. -Input data structure: D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS_INPUT + Input data structure: D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS_INPUT -Output data structure: D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS_COUNT
-
-		 -Returns the number of processes that are allowed to open shared resources with restricted access. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS_COUNT +
+
+ 		+ Returns the number of processes that are allowed to open shared resources with restricted access. -Output data structure: D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS_COUNT_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS_COUNT_OUTPUT -
-
D3D11_AUTHENTICATED_QUERY_UNRESTRICTED_PROTECTED_SHARED_RESOURCE_COUNT
-
-		 -Returns the number of protected shared resources that can be opened by any process with no restrictions. +
+ + +
+
+ D3D11_AUTHENTICATED_QUERY_UNRESTRICTED_PROTECTED_SHARED_RESOURCE_COUNT +
+
+ 		+ Returns the number of protected shared resources that can be opened by any process with no restrictions. -Output data structure: D3D11_AUTHENTICATED_QUERY_UNRESTRICTED_PROTECTED_SHARED_RESOURCE_COUNT_OUTPUT + Output data structure: D3D11_AUTHENTICATED_QUERY_UNRESTRICTED_PROTECTED_SHARED_RESOURCE_COUNT_OUTPUT -
+
+ - A handle to the authenticated channel. To get the handle, call the ID3D11AuthenticatedChannel::GetChannelHandle method. + + A handle to the authenticated channel. To get the handle, call the ID3D11AuthenticatedChannel::GetChannelHandle method. + The query sequence number. At the start of the session, generate a cryptographically secure 32-bit random number to use as the starting sequence number. For each query, increment the sequence number by 1. @@ -5384,14 +7444,18 @@ Output data structure: Describes a library. - Microsoft Docs: + + Microsoft Docs: + The name of the originator of the library. - A combination of D3DCOMPILE Constants that are combined by using a bitwise OR operation. The resulting value specifies how the compiler compiles. + + A combination of D3DCOMPILE Constants that are combined by using a bitwise OR operation. The resulting value specifies how the compiler compiles. + The number of functions exported from the library. @@ -5399,7 +7463,9 @@ Output data structure: Describes the coordinates of a tiled resource. - Microsoft Docs: + + Microsoft Docs: + @@ -5412,22 +7478,30 @@ Output data structure: - A subresource index value into mipmaps and arrays. Used for 1D, 2D, and 3D textures. + + A subresource index value into mipmaps and arrays. Used for 1D, 2D, and 3D textures. -For mipmaps that use nonstandard tiling, or are packed, or both use nonstandard tiling and are packed, any subresource value that indicates any of the packed mipmaps all refer to the same tile. + For mipmaps that use nonstandard tiling, or are packed, or both use nonstandard tiling and are packed, any subresource value that indicates any of the packed mipmaps all refer to the same tile. + Sets the depth-stencil state of the output-merger stage. - Microsoft Docs: - Pointer to a depth-stencil state interface (see ID3D11DepthStencilState) to bind to the device. Set this to NULL to use the default state listed in D3D11_DEPTH_STENCIL_DESC. + + Microsoft Docs: + + + Pointer to a depth-stencil state interface (see ID3D11DepthStencilState) to bind to the device. Set this to NULL to use the default state listed in D3D11_DEPTH_STENCIL_DESC. + Reference value to perform against when doing a depth-stencil test. See remarks. Specifies indices for arrays of per component histogram infromation. - Microsoft Docs: + + Microsoft Docs: + @@ -5454,7 +7528,9 @@ For mipmaps that use nonstandard tiling, or are packed, or both use nonstandard Specifies the type of Microsoft Direct3D authenticated channel. - Microsoft Docs: + + Microsoft Docs: + @@ -5469,50 +7545,76 @@ For mipmaps that use nonstandard tiling, or are packed, or both use nonstandard Draw instanced, GPU-generated primitives. - Microsoft Docs: - A pointer to an ID3D11Buffer, which is a buffer containing the GPU generated primitives. - Offset in pBufferForArgs to the start of the GPU generated primitives. + + Microsoft Docs: + + + A pointer to an ID3D11Buffer, which is a buffer containing the GPU generated primitives. + + + Offset in pBufferForArgs to the start of the GPU generated primitives. + Set a vertex shader to the device. - Microsoft Docs: - Pointer to a vertex shader (see ID3D11VertexShader). Passing in NULL disables the shader for this pipeline stage. - A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + + Microsoft Docs: + + + Pointer to a vertex shader (see ID3D11VertexShader). Passing in NULL disables the shader for this pipeline stage. + + + A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + The number of class-instance interfaces in the array. Gets a description of the current HLSL class. - Microsoft Docs: - A pointer to a D3D11_CLASS_INSTANCE_DESC structure that describes the current HLSL class. + + Microsoft Docs: + + + A pointer to a D3D11_CLASS_INSTANCE_DESC structure that describes the current HLSL class. + Fills the function descriptor structure for the function. - Microsoft Docs: - A pointer to a D3D11_FUNCTION_DESC structure that receives a description of the function. + + Microsoft Docs: + + + A pointer to a D3D11_FUNCTION_DESC structure that receives a description of the function. + Gets the feature level of the hardware device. - Microsoft Docs: + + Microsoft Docs: + Gets the number of profiles that are supported by the driver. - Microsoft Docs: + + Microsoft Docs: + Specifies an event that should be fired when the fence reaches a certain value. - Microsoft Docs: + + Microsoft Docs: + The fence value when the event is to be signaled. A handle to the event object. @@ -5520,116 +7622,168 @@ For mipmaps that use nonstandard tiling, or are packed, or both use nonstandard Describes parameters that are used to create a device. - Microsoft Docs: + + Microsoft Docs: + - Use this flag if your application will only call methods of Direct3D 11 interfaces from a single thread. By default, the ID3D11Device object is thread-safe. - By using this flag, you can increase performance. However, if you use this flag and your application calls methods of Direct3D 11 interfaces from multiple threads, undefined behavior might result. + + Use this flag if your application will only call methods of Direct3D 11 interfaces from a single thread. By default, the ID3D11Device object is thread-safe. + By using this flag, you can increase performance. However, if you use this flag and your application calls methods of Direct3D 11 interfaces from multiple threads, undefined behavior might result. + - Creates a device that supports the debug layer. + + Creates a device that supports the debug layer. -To use this flag, you must have D3D11*SDKLayers.dll installed; otherwise, device creation fails. To get D3D11_1SDKLayers.dll, install the SDK for Windows 8. + To use this flag, you must have D3D11*SDKLayers.dll installed; otherwise, device creation fails. To get D3D11_1SDKLayers.dll, install the SDK for Windows 8. + -
Note  This flag is not supported in Direct3D 11.
-
 
 + +
+ Note  This flag is not supported in Direct3D 11. +
+
 
+ - Prevents multiple threads from being created. When this flag is used with a Windows Advanced Rasterization Platform (WARP) device, no additional threads will be created by WARP - and all rasterization will occur on the calling thread. This flag is not recommended for general use. See remarks. + + Prevents multiple threads from being created. When this flag is used with a Windows Advanced Rasterization Platform (WARP) device, no additional threads will be created by WARP + and all rasterization will occur on the calling thread. This flag is not recommended for general use. See remarks. + - Creates a device that supports BGRA formats (DXGI_FORMAT_B8G8R8A8_UNORM and DXGI_FORMAT_B8G8R8A8_UNORM_SRGB). All 10level9 and higher hardware with WDDM 1.1+ drivers support BGRA formats. + + Creates a device that supports BGRA formats (DXGI_FORMAT_B8G8R8A8_UNORM and DXGI_FORMAT_B8G8R8A8_UNORM_SRGB). All 10level9 and higher hardware with WDDM 1.1+ drivers support BGRA formats. -
Note  Required for Direct2D interoperability with Direct3D resources.
-
 
 +
+ Note  Required for Direct2D interoperability with Direct3D resources. +
+
 
+ - Causes the device and driver to keep information that you can use for shader debugging. The exact impact from this flag will vary from driver to driver. + + Causes the device and driver to keep information that you can use for shader debugging. The exact impact from this flag will vary from driver to driver. -To use this flag, you must have D3D11_1SDKLayers.dll installed; otherwise, device creation fails. The created device supports the debug layer. To get D3D11_1SDKLayers.dll, install the SDK for Windows 8. + To use this flag, you must have D3D11_1SDKLayers.dll installed; otherwise, device creation fails. The created device supports the debug layer. To get D3D11_1SDKLayers.dll, install the SDK for Windows 8. -If you use this flag and the current driver does not support shader debugging, device creation fails. Shader debugging requires a driver that is implemented to the WDDM for Windows 8 (WDDM 1.2). + If you use this flag and the current driver does not support shader debugging, device creation fails. Shader debugging requires a driver that is implemented to the WDDM for Windows 8 (WDDM 1.2). -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Causes the Direct3D runtime to ignore registry settings that turn on the debug layer. You can turn on the debug layer by using the DirectX Control Panel that was included as part of the DirectX SDK. We shipped the last version of the DirectX SDK in June 2010; you can download it from the Microsoft Download Center. You can set this flag in your app, typically in release builds only, to prevent end users from using the DirectX Control Panel to monitor how the app uses Direct3D. + + Causes the Direct3D runtime to ignore registry settings that turn on the debug layer. You can turn on the debug layer by using the DirectX Control Panel that was included as part of the DirectX SDK. We shipped the last version of the DirectX SDK in June 2010; you can download it from the Microsoft Download Center. You can set this flag in your app, typically in release builds only, to prevent end users from using the DirectX Control Panel to monitor how the app uses Direct3D. -
Note  You can also set this flag in your app to prevent Direct3D debugging tools, such as Visual Studio Ultimate 2012, from hooking your app.
-
 
-Windows 8.1:  This flag doesn't prevent Visual Studio 2013 and later running on Windows 8.1 and later from hooking your app; instead use ID3D11DeviceContext2::IsAnnotationEnabled. This flag still prevents Visual Studio 2013 and later running on Windows 8 and earlier from hooking your app. +
+ Note  You can also set this flag in your app to prevent Direct3D debugging tools, such as Visual Studio Ultimate 2012, from hooking your app. +
+
 
+ Windows 8.1:  This flag doesn't prevent Visual Studio 2013 and later running on Windows 8.1 and later from hooking your app; instead use ID3D11DeviceContext2::IsAnnotationEnabled. This flag still prevents Visual Studio 2013 and later running on Windows 8 and earlier from hooking your app. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Use this flag if the device will produce GPU workloads that take more than two seconds to complete, and you want the operating system to allow them to successfully finish. If this flag is not set, the operating system performs timeout detection and recovery when it detects a GPU packet that took more than two seconds to execute. If this flag is set, the operating system allows such a long running packet to execute without resetting the GPU. We recommend not to set this flag if your device needs to be highly responsive so that the operating system can detect and recover from GPU timeouts. We recommend to set this flag if your device needs to perform time consuming background tasks such as compute, image recognition, and video encoding to allow such tasks to successfully finish. + + Use this flag if the device will produce GPU workloads that take more than two seconds to complete, and you want the operating system to allow them to successfully finish. If this flag is not set, the operating system performs timeout detection and recovery when it detects a GPU packet that took more than two seconds to execute. If this flag is set, the operating system allows such a long running packet to execute without resetting the GPU. We recommend not to set this flag if your device needs to be highly responsive so that the operating system can detect and recover from GPU timeouts. We recommend to set this flag if your device needs to perform time consuming background tasks such as compute, image recognition, and video encoding to allow such tasks to successfully finish. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Forces the creation of the Direct3D device to fail if the display driver is not implemented to the WDDM for Windows 8 (WDDM 1.2). When the display driver is not implemented to WDDM 1.2, only a Direct3D device that is created with feature level 9.1, 9.2, or 9.3 supports video; therefore, if this flag is set, the runtime creates the Direct3D device only for feature level 9.1, 9.2, or 9.3. We recommend not to specify this flag for applications that want to favor Direct3D capability over video. If feature level 10 and higher is available, the runtime will use that feature level regardless of video support. + + Forces the creation of the Direct3D device to fail if the display driver is not implemented to the WDDM for Windows 8 (WDDM 1.2). When the display driver is not implemented to WDDM 1.2, only a Direct3D device that is created with feature level 9.1, 9.2, or 9.3 supports video; therefore, if this flag is set, the runtime creates the Direct3D device only for feature level 9.1, 9.2, or 9.3. We recommend not to specify this flag for applications that want to favor Direct3D capability over video. If feature level 10 and higher is available, the runtime will use that feature level regardless of video support. -If this flag is set, device creation on the Basic Render Device (BRD) will succeed regardless of the BRD's missing support for video decode. This is because the Media Foundation video stack operates in software mode on BRD. In this situation, if you force the video stack to create the Direct3D device twice (create the device once with this flag, next discover BRD, then again create the device without the flag), you actually degrade performance. + If this flag is set, device creation on the Basic Render Device (BRD) will succeed regardless of the BRD's missing support for video decode. This is because the Media Foundation video stack operates in software mode on BRD. In this situation, if you force the video stack to create the Direct3D device twice (create the device once with this flag, next discover BRD, then again create the device without the flag), you actually degrade performance. -If you attempt to create a Direct3D device with driver type D3D_DRIVER_TYPE_NULL, D3D_DRIVER_TYPE_REFERENCE, or D3D_DRIVER_TYPE_SOFTWARE, device creation fails at any feature level because none of the associated drivers provide video capability. If you attempt to create a Direct3D device with driver type D3D_DRIVER_TYPE_WARP, device creation succeeds to allow software fallback for video. + If you attempt to create a Direct3D device with driver type D3D_DRIVER_TYPE_NULL, D3D_DRIVER_TYPE_REFERENCE, or D3D_DRIVER_TYPE_SOFTWARE, device creation fails at any feature level because none of the associated drivers provide video capability. If you attempt to create a Direct3D device with driver type D3D_DRIVER_TYPE_WARP, device creation succeeds to allow software fallback for video. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + Specifies the subresource from a 2D texture to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + - Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original Texture2D for which ID3D11Device::CreateShaderResourceView creates a view) -1. + + Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original Texture2D for which ID3D11Device::CreateShaderResourceView creates a view) -1. + - The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. + + The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. -Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + Creates a deferred context, which can record command lists. - Microsoft Docs: - Reserved for future use. - Pass 0. - Upon completion of the method, the passed pointer to an ID3D11DeviceContext interface pointer is initialized. + + Microsoft Docs: + + + Reserved for future use. + Pass 0. + + + Upon completion of the method, the passed pointer to an ID3D11DeviceContext interface pointer is initialized. + Defines stereo 3D capabilities for a Microsoft Direct3D 11 video processor. - Microsoft Docs: + + Microsoft Docs: + - The video processor supports the D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET - format. + + The video processor supports the D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET + format. + - The video processor supports the D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_ROW_INTERLEAVED - format. + + The video processor supports the D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_ROW_INTERLEAVED + format. + - The video processor supports the D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_COLUMN_INTERLEAVED - format. + + The video processor supports the D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_COLUMN_INTERLEAVED + format. + - The video processor supports the D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_CHECKERBOARD - format. + + The video processor supports the D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_CHECKERBOARD + format. + - The video processor can flip one or both views. For more information, see D3D11_VIDEO_PROCESSOR_STEREO_FLIP_MODE. + + The video processor can flip one or both views. For more information, see D3D11_VIDEO_PROCESSOR_STEREO_FLIP_MODE. + Identifies how to bind a resource to the pipeline. - Microsoft Docs: + + Microsoft Docs: + @@ -5642,10 +7796,14 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Bind a buffer as a constant buffer to a shader stage; this flag may NOT be combined with any other bind flag. - Bind a buffer or texture to a shader stage; this flag cannot be used with the D3D11_MAP_WRITE_NO_OVERWRITE flag. + + Bind a buffer or texture to a shader stage; this flag cannot be used with the D3D11_MAP_WRITE_NO_OVERWRITE flag. -
Note  The Direct3D 11.1 runtime, which is available starting with Windows 8, enables mapping dynamic constant buffers and shader resource views (SRVs) of dynamic buffers with D3D11_MAP_WRITE_NO_OVERWRITE. The Direct3D 11 and earlier runtimes limited mapping to vertex or index buffers. To determine if a Direct3D device supports these features, call ID3D11Device::CheckFeatureSupport with D3D11_FEATURE_D3D11_OPTIONS. CheckFeatureSupport fills members of a D3D11_FEATURE_DATA_D3D11_OPTIONS structure with the device's features. The relevant members here are MapNoOverwriteOnDynamicConstantBuffer and MapNoOverwriteOnDynamicBufferSRV.
-
 
 +
+ Note  The Direct3D 11.1 runtime, which is available starting with Windows 8, enables mapping dynamic constant buffers and shader resource views (SRVs) of dynamic buffers with D3D11_MAP_WRITE_NO_OVERWRITE. The Direct3D 11 and earlier runtimes limited mapping to vertex or index buffers. To determine if a Direct3D device supports these features, call ID3D11Device::CheckFeatureSupport with D3D11_FEATURE_D3D11_OPTIONS. CheckFeatureSupport fills members of a D3D11_FEATURE_DATA_D3D11_OPTIONS structure with the device's features. The relevant members here are MapNoOverwriteOnDynamicConstantBuffer and MapNoOverwriteOnDynamicBufferSRV. +
+
 
+ Bind an output buffer for the stream-output stage. @@ -5657,22 +7815,30 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Bind a texture as a depth-stencil target for the output-merger stage. - Bind an unordered access resource. + + Bind an unordered access resource. + - Set this flag to indicate that a 2D texture is used to receive output from the decoder API. The common way to create resources for a decoder output is by calling the ID3D11Device::CreateTexture2D method to create an array of 2D textures. However, you cannot use texture arrays that are created with this flag in calls to ID3D11Device::CreateShaderResourceView. + + Set this flag to indicate that a 2D texture is used to receive output from the decoder API. The common way to create resources for a decoder output is by calling the ID3D11Device::CreateTexture2D method to create an array of 2D textures. However, you cannot use texture arrays that are created with this flag in calls to ID3D11Device::CreateShaderResourceView. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Set this flag to indicate that a 2D texture is used to receive input from the video encoder API. The common way to create resources for a video encoder is by calling the ID3D11Device::CreateTexture2D method to create an array of 2D textures. However, you cannot use texture arrays that are created with this flag in calls to ID3D11Device::CreateShaderResourceView. + + Set this flag to indicate that a 2D texture is used to receive input from the video encoder API. The common way to create resources for a video encoder is by calling the ID3D11Device::CreateTexture2D method to create an array of 2D textures. However, you cannot use texture arrays that are created with this flag in calls to ID3D11Device::CreateShaderResourceView. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + Query information about graphics-pipeline activity in between calls to ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. - Microsoft Docs: + + Microsoft Docs: + @@ -5685,7 +7851,9 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Number of times a vertex shader was invoked. Direct3D invokes the vertex shader once per vertex. - Number of times a geometry shader was invoked. When the geometry shader is set to NULL, this statistic may or may not increment depending on the hardware manufacturer. + + Number of times a geometry shader was invoked. When the geometry shader is set to NULL, this statistic may or may not increment depending on the hardware manufacturer. + Number of primitives output by a geometry shader. @@ -5711,211 +7879,320 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Get a shader description. - Microsoft Docs: - A pointer to a shader description. See D3D11_SHADER_DESC. + + Microsoft Docs: + + + A pointer to a shader description. See D3D11_SHADER_DESC. + Creates a predicate. - Microsoft Docs: - Pointer to a query description where the type of query must be a D3D11_QUERY_SO_OVERFLOW_PREDICATE or D3D11_QUERY_OCCLUSION_PREDICATE (see D3D11_QUERY_DESC). - Address of a pointer to a predicate (see ID3D11Predicate). + + Microsoft Docs: + + + Pointer to a query description where the type of query must be a D3D11_QUERY_SO_OVERFLOW_PREDICATE or D3D11_QUERY_OCCLUSION_PREDICATE (see D3D11_QUERY_DESC). + + + Address of a pointer to a predicate (see ID3D11Predicate). + Get the constant buffers used by the compute-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + + Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + Gets the stereo 3D format for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Receives the value TRUE if stereo 3D is enabled for this stream, or FALSE otherwise. If the value is FALSE, ignore the remaining parameters. - Receives a D3D11_VIDEO_PROCESSOR_STEREO_FORMAT value that specifies the layout of the two stereo views in memory. - Receives a Boolean value. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Receives the value TRUE if stereo 3D is enabled for this stream, or FALSE otherwise. If the value is FALSE, ignore the remaining parameters. + + + Receives a D3D11_VIDEO_PROCESSOR_STEREO_FORMAT value that specifies the layout of the two stereo views in memory. + + + Receives a Boolean value. - - - - - - - - + +
ValueMeaning
-
TRUE
-
-		 -Frame 0 contains the left view. + + + + + + + + - - - - + + + + - -
ValueMeaning
+ + +
+
+ TRUE +
+
+ 		+ Frame 0 contains the left view. -
-
FALSE
-
-		 -Frame 0 contains the right view. +
+ + +
+
+ FALSE +
+
+ 		+ Frame 0 contains the right view. -
- Receives a Boolean value. +
+ + + Receives a Boolean value. - - - - - - - - + +
ValueMeaning
-
TRUE
-
-		 -Frame 0 contains the base view. + + + + + + + + - - - - + + + + - -
ValueMeaning
+ + +
+
+ TRUE +
+
+ 		+ Frame 0 contains the base view. -
-
FALSE
-
-		 -Frame 1 contains the base view. +
+ + +
+
+ FALSE +
+
+ 		+ Frame 1 contains the base view. -
- Receives a D3D11_VIDEO_PROCESSOR_STEREO_FLIP_MODE value. This value specifies whether one of the views is flipped. - Receives the pixel offset used for D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET format. This parameter is ignored for other stereo formats. +
+ + + Receives a D3D11_VIDEO_PROCESSOR_STEREO_FLIP_MODE value. This value specifies whether one of the views is flipped. + + + Receives the pixel offset used for D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET format. This parameter is ignored for other stereo formats. + Sets the color space information for the video processor output surface. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. - A DXGI_COLOR_SPACE_TYPE value that specifies the colorspace for the video processor output surface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + + + A DXGI_COLOR_SPACE_TYPE value that specifies the colorspace for the video processor output surface. + Creates a rasterizer state object that informs the rasterizer stage how to behave and forces the sample count while UAV rendering or rasterizing. - Microsoft Docs: - A pointer to a D3D11_RASTERIZER_DESC2 structure that describes the rasterizer state. - A pointer to a memory block that receives a pointer to a ID3D11RasterizerState2 interface for the created rasterizer state object. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + + Microsoft Docs: + + + A pointer to a D3D11_RASTERIZER_DESC2 structure that describes the rasterizer state. + + + A pointer to a memory block that receives a pointer to a ID3D11RasterizerState2 interface for the created rasterizer state object. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Defines features that a Microsoft Direct3D 11 video processor can support. - Microsoft Docs: + + Microsoft Docs: + - The video processor can set alpha values on the output pixels. For more information, see ID3D11VideoContext::VideoProcessorSetOutputAlphaFillMode. + + The video processor can set alpha values on the output pixels. For more information, see ID3D11VideoContext::VideoProcessorSetOutputAlphaFillMode. + - The video processor can downsample the video output. For more information, see ID3D11VideoContext::VideoProcessorSetOutputConstriction. + + The video processor can downsample the video output. For more information, see ID3D11VideoContext::VideoProcessorSetOutputConstriction. + - The video processor can perform luma keying. For more information, see ID3D11VideoContext::VideoProcessorSetStreamLumaKey. + + The video processor can perform luma keying. For more information, see ID3D11VideoContext::VideoProcessorSetStreamLumaKey. + The video processor can apply alpha values from color palette entries. - The driver does not support full video processing capabilities. If this capability flag is set, the video processor has the following limitations: + + The driver does not support full video processing capabilities. If this capability flag is set, the video processor has the following limitations: -
    -
  • A maximum of two streams are supported:
      -
    • The first stream must be either NV12 or YUY2.
      • -
    • The second stream must be AYUV, AI44, or IA44.
      • -
    -
    • -
  • Image adjustment (proc amp) controls are applied to the entire video processing blit, rather than per stream.
    • -
  • Support for per-stream planar alpha is not reliable. (Per-pixel alpha is supported, however.)
    • -
 +
    +
  • + A maximum of two streams are supported:
      +
    • The first stream must be either NV12 or YUY2.
      • +
    • The second stream must be AYUV, AI44, or IA44.
      • +
    +
    • +
  • Image adjustment (proc amp) controls are applied to the entire video processing blit, rather than per stream.
    • +
  • Support for per-stream planar alpha is not reliable. (Per-pixel alpha is supported, however.)
    • +
+ - The video processor can support 3D stereo video. For more information, see ID3D11VideoContext::VideoProcessorSetStreamStereoFormat. + + The video processor can support 3D stereo video. For more information, see ID3D11VideoContext::VideoProcessorSetStreamStereoFormat. -All drivers setting this caps must support the following stereo formats: D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_HORIZONTAL, D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_VERTICAL, and D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE. + All drivers setting this caps must support the following stereo formats: D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_HORIZONTAL, D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_VERTICAL, and D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE. + The driver can rotate the input data either 90, 180, or 270 degrees clockwise as part of the video processing operation. - The driver supports the VideoProcessorSetStreamAlpha call. + + The driver supports the VideoProcessorSetStreamAlpha call. + - The driver supports the VideoProcessorSetStreamPixelAspectRatio call. + + The driver supports the VideoProcessorSetStreamPixelAspectRatio call. + A 2D texture interface manages texel data, which is structured memory. - Microsoft Docs: + + Microsoft Docs: + Sets a pixel shader to the device. - Microsoft Docs: - Pointer to a pixel shader (see ID3D11PixelShader). Passing in NULL disables the shader for this pipeline stage. - A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + + Microsoft Docs: + + + Pointer to a pixel shader (see ID3D11PixelShader). Passing in NULL disables the shader for this pipeline stage. + + + A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + The number of class-instance interfaces in the array. Sets a driver-specific video processing state. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + A pointer to a GUID that identifies the operation. The meaning of this GUID is defined by the graphics driver. - The size of the pData buffer, in bytes. + + The size of the pData buffer, in bytes. + A pointer to a buffer that contains private state data. The method passes this buffer directly to the driver without validation. It is the responsibility of the driver to validate the data. Copies data from a buffer holding variable length data. - Microsoft Docs: - Pointer to ID3D11Buffer. This can be any buffer resource that other copy commands, - such as ID3D11DeviceContext::CopyResource or ID3D11DeviceContext::CopySubresourceRegion, are able to write to. - Offset from the start of pDstBuffer to write 32-bit UINT structure (vertex) count from pSrcView. - Pointer to an ID3D11UnorderedAccessView of a Structured Buffer resource created with either - D3D11_BUFFER_UAV_FLAG_APPEND or D3D11_BUFFER_UAV_FLAG_COUNTER specified - when the UAV was created. These types of resources have hidden counters tracking "how many" records have - been written. + + Microsoft Docs: + + + Pointer to ID3D11Buffer. This can be any buffer resource that other copy commands, + such as ID3D11DeviceContext::CopyResource or ID3D11DeviceContext::CopySubresourceRegion, are able to write to. + + + Offset from the start of pDstBuffer to write 32-bit UINT structure (vertex) count from pSrcView. + + + Pointer to an ID3D11UnorderedAccessView of a Structured Buffer resource created with either + D3D11_BUFFER_UAV_FLAG_APPEND or D3D11_BUFFER_UAV_FLAG_COUNTER specified + when the UAV was created. These types of resources have hidden counters tracking "how many" records have + been written. + Gets whether hardware protection is enabled. - Microsoft Docs: + + Microsoft Docs: + After this method returns, points to a BOOL that indicates whether hardware protection is enabled. Get the size of the retrieval-filter stack in bytes. - Microsoft Docs: + + Microsoft Docs: + Provides information about the input streams passed into the ID3DVideoContext1::VideoProcessorGetBehaviorHints method. - Microsoft Docs: + + Microsoft Docs: + @@ -5933,35 +8210,49 @@ All drivers setting this caps must support the following stereo formats: Gets the number of interfaces. - Microsoft Docs: + + Microsoft Docs: + An information-queue interface stores, retrieves, and filters debug messages. The queue consists of a message queue, an optional storage filter stack, and a optional retrieval filter stack. - Microsoft Docs: + + Microsoft Docs: + Get the constant buffers used by the pixel shader pipeline stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + + Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + Indicates whether a class type implements an interface. - Microsoft Docs: - A pointer to a ID3D11ShaderReflectionType Interface. + + Microsoft Docs: + + + A pointer to a ID3D11ShaderReflectionType Interface. + Specifies the subresource from a multisampled 2D texture to use in a render-target view. - Microsoft Docs: + + Microsoft Docs: + @@ -5970,64 +8261,96 @@ All drivers setting this caps must support the following stereo formats: An ID3D11ShaderTrace interface implements methods for obtaining traces of shader executions. - Microsoft Docs: + + Microsoft Docs: + A predicate interface determines whether geometry should be processed depending on the results of a previous draw call. - Microsoft Docs: + + Microsoft Docs: + Sets the planar alpha for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + Specifies whether alpha blending is enabled. - The planar alpha value. The value can range from 0.0 (transparent) to 1.0 (opaque). - If Enable is FALSE, this parameter is ignored. + + The planar alpha value. The value can range from 0.0 (transparent) to 1.0 (opaque). + If Enable is FALSE, this parameter is ignored. + Describes a video decoder output view. - Microsoft Docs: + + Microsoft Docs: + - The decoding profile. To get the list of profiles supported by the device, call the ID3D11VideoDevice::GetVideoDecoderProfile method. + + The decoding profile. To get the list of profiles supported by the device, call the ID3D11VideoDevice::GetVideoDecoderProfile method. + - The resource type of the view, specified as a member of the D3D11_VDOV_DIMENSION enumeration. + + The resource type of the view, specified as a member of the D3D11_VDOV_DIMENSION enumeration. + - A D3D11_TEX2D_VDOV structure that identifies the texture resource for the output view. + + A D3D11_TEX2D_VDOV structure that identifies the texture resource for the output view. + Gets the geometry-shader input-primitive description. - Microsoft Docs: + + Microsoft Docs: + Describes the configuration of a Microsoft Direct3D 11 decoder device for DirectX Video Acceleration (DXVA). - Microsoft Docs: + + Microsoft Docs: + - If the bitstream data buffers are encrypted using the D3D11CryptoSession mechanism, this GUID should be set to zero. If no encryption is applied, the value is DXVA_NoEncrypt. If ConfigBitstreamRaw is 0, the value must be DXVA_NoEncrypt. + + If the bitstream data buffers are encrypted using the D3D11CryptoSession mechanism, this GUID should be set to zero. If no encryption is applied, the value is DXVA_NoEncrypt. If ConfigBitstreamRaw is 0, the value must be DXVA_NoEncrypt. + - If the macroblock control data buffers are encrypted using the D3D11CryptoSession mechanism, this GUID should be set to zero. If no encryption is applied, the value is DXVA_NoEncrypt. If ConfigBitstreamRaw is 1, the value must be DXVA_NoEncrypt. + + If the macroblock control data buffers are encrypted using the D3D11CryptoSession mechanism, this GUID should be set to zero. If no encryption is applied, the value is DXVA_NoEncrypt. If ConfigBitstreamRaw is 1, the value must be DXVA_NoEncrypt. + - If the residual difference decoding data buffers are encrypted using the D3D11CryptoSession mechanism, this GUID should be set to zero. If no encryption is applied, the value is DXVA_NoEncrypt. If ConfigBitstreamRaw is 1, the value must be DXVA_NoEncrypt. + + If the residual difference decoding data buffers are encrypted using the D3D11CryptoSession mechanism, this GUID should be set to zero. If no encryption is applied, the value is DXVA_NoEncrypt. If ConfigBitstreamRaw is 1, the value must be DXVA_NoEncrypt. + - Indicates whether the host-decoder sends raw bit-stream data. If the value is 1, the data for the pictures will be sent in bit-stream buffers as raw bit-stream content. If the value is 0, picture data will be sent using macroblock control command buffers. If either ConfigResidDiffHost or ConfigResidDiffAccelerator is 1, the value must be 0. + + Indicates whether the host-decoder sends raw bit-stream data. If the value is 1, the data for the pictures will be sent in bit-stream buffers as raw bit-stream content. If the value is 0, picture data will be sent using macroblock control command buffers. If either ConfigResidDiffHost or ConfigResidDiffAccelerator is 1, the value must be 0. + Specifies whether macroblock control commands are in raster scan order or in arbitrary order. If the value is 1, the macroblock control commands within each macroblock control command buffer are in raster-scan order. If the value is 0, the order is arbitrary. For some types of bit streams, forcing raster order either greatly increases the number of required macroblock control buffers that must be processed, or requires host reordering of the control information. Therefore, supporting arbitrary order can be more efficient. @@ -6036,98 +8359,126 @@ All drivers setting this caps must support the following stereo formats: Contains the host residual difference configuration. If the value is 1, some residual difference decoding data may be sent as blocks in the spatial domain from the host. If the value is 0, spatial domain data will not be sent. - Indicates the word size used to represent residual difference spatial-domain blocks for predicted (non-intra) pictures when using host-based residual difference decoding. - + + Indicates the word size used to represent residual difference spatial-domain blocks for predicted (non-intra) pictures when using host-based residual difference decoding. -If ConfigResidDiffHost is 1 and ConfigSpatialResid8 is 1, the host will send residual difference spatial-domain blocks for non-intra macroblocks using 8-bit signed samples and for intra macroblocks in predicted (non-intra) pictures in a format that depends on the value of ConfigIntraResidUnsigned: - -
    -
  • If ConfigIntraResidUnsigned is 0, spatial-domain blocks for intra macroblocks are sent as 8-bit signed integer values relative to a constant reference value of 2^(BPP–1). -
    • -
  • If ConfigIntraResidUnsigned is 1, spatial-domain blocks for intra macroblocks are sent as 8-bit unsigned integer values relative to a constant reference value of 0. -
    • -
-If ConfigResidDiffHost is 1 and ConfigSpatialResid8 is 0, the host will send residual difference spatial-domain blocks of data for non-intra macroblocks using 16-bit signed samples and for intra macroblocks in predicted (non-intra) pictures in a format that depends on the value of ConfigIntraResidUnsigned: - + If ConfigResidDiffHost is 1 and ConfigSpatialResid8 is 1, the host will send residual difference spatial-domain blocks for non-intra macroblocks using 8-bit signed samples and for intra macroblocks in predicted (non-intra) pictures in a format that depends on the value of ConfigIntraResidUnsigned: -
    -
  • If ConfigIntraResidUnsigned is 0, spatial domain blocks for intra macroblocks are sent as 16-bit signed integer values relative to a constant reference value of 2^(BPP–1). -
    • -
  • If ConfigIntraResidUnsigned is 1, spatial domain blocks for intra macroblocks are sent as 16-bit unsigned integer values relative to a constant reference value of 0. -
    • -
-If ConfigResidDiffHost is 0, ConfigSpatialResid8 must be 0. - -For intra pictures, spatial-domain blocks must be sent using 8-bit samples if bits-per-pixel (BPP) is 8, and using 16-bit samples if BPP > 8. If ConfigIntraResidUnsigned is 0, these samples are sent as signed integer values relative to a constant reference value of 2^(BPP–1), and if ConfigIntraResidUnsigned is 1, these samples are sent as unsigned integer values relative to a constant reference value of 0. +
    +
  • + If ConfigIntraResidUnsigned is 0, spatial-domain blocks for intra macroblocks are sent as 8-bit signed integer values relative to a constant reference value of 2^(BPP–1). +
    • +
  • + If ConfigIntraResidUnsigned is 1, spatial-domain blocks for intra macroblocks are sent as 8-bit unsigned integer values relative to a constant reference value of 0. +
    • +
+ If ConfigResidDiffHost is 1 and ConfigSpatialResid8 is 0, the host will send residual difference spatial-domain blocks of data for non-intra macroblocks using 16-bit signed samples and for intra macroblocks in predicted (non-intra) pictures in a format that depends on the value of ConfigIntraResidUnsigned: + + +
    +
  • + If ConfigIntraResidUnsigned is 0, spatial domain blocks for intra macroblocks are sent as 16-bit signed integer values relative to a constant reference value of 2^(BPP–1). +
    • +
  • + If ConfigIntraResidUnsigned is 1, spatial domain blocks for intra macroblocks are sent as 16-bit unsigned integer values relative to a constant reference value of 0. +
    • +
+ If ConfigResidDiffHost is 0, ConfigSpatialResid8 must be 0. + + + For intra pictures, spatial-domain blocks must be sent using 8-bit samples if bits-per-pixel (BPP) is 8, and using 16-bit samples if BPP > 8. If ConfigIntraResidUnsigned is 0, these samples are sent as signed integer values relative to a constant reference value of 2^(BPP–1), and if ConfigIntraResidUnsigned is 1, these samples are sent as unsigned integer values relative to a constant reference value of 0. + - If the value is 1, 8-bit difference overflow blocks are subtracted rather than added. The value must be 0 unless ConfigSpatialResid8 is 1. - + + If the value is 1, 8-bit difference overflow blocks are subtracted rather than added. The value must be 0 unless ConfigSpatialResid8 is 1. -The ability to subtract differences rather than add them enables 8-bit difference decoding to be fully compliant with the full ±255 range of values required in video decoder specifications, because +255 cannot be represented as the addition of two signed 8-bit numbers, but any number in the range ±255 can be represented as the difference between two signed 8-bit numbers (+255 = +127 minus –128). + + The ability to subtract differences rather than add them enables 8-bit difference decoding to be fully compliant with the full ±255 range of values required in video decoder specifications, because +255 cannot be represented as the addition of two signed 8-bit numbers, but any number in the range ±255 can be represented as the difference between two signed 8-bit numbers (+255 = +127 minus –128). + - If the value is 1, spatial-domain blocks for intra macroblocks must be clipped to an 8-bit range on the host and spatial-domain blocks for non-intra macroblocks must be clipped to a 9-bit range on the host. If the value is 0, no such clipping is necessary by the host. - + + If the value is 1, spatial-domain blocks for intra macroblocks must be clipped to an 8-bit range on the host and spatial-domain blocks for non-intra macroblocks must be clipped to a 9-bit range on the host. If the value is 0, no such clipping is necessary by the host. -The value must be 0 unless ConfigSpatialResid8 is 0 and ConfigResidDiffHost is 1. + + The value must be 0 unless ConfigSpatialResid8 is 0 and ConfigResidDiffHost is 1. + - If the value is 1, any spatial-domain residual difference data must be sent in a chrominance-interleaved form matching the YUV format chrominance interleaving pattern. The value must be 0 unless ConfigResidDiffHost is 1 and the YUV format is NV12 or NV21. + + If the value is 1, any spatial-domain residual difference data must be sent in a chrominance-interleaved form matching the YUV format chrominance interleaving pattern. The value must be 0 unless ConfigResidDiffHost is 1 and the YUV format is NV12 or NV21. + - Indicates the method of representation of spatial-domain blocks of residual difference data for intra blocks when using host-based difference decoding. - + + Indicates the method of representation of spatial-domain blocks of residual difference data for intra blocks when using host-based difference decoding. -If ConfigResidDiffHost is 1 and ConfigIntraResidUnsigned is 0, spatial-domain residual difference data blocks for intra macroblocks must be sent as follows: - -
    -
  • In a non-intra picture, if ConfigSpatialResid8 is 0, the spatial-domain residual difference data blocks for intra macroblocks are sent as 16-bit signed integer values relative to a constant reference value of 2^(BPP–1). -
    • -
  • In a non-intra picture, if ConfigSpatialResid8 is 1, the spatial-domain residual difference data blocks for intra macroblocks are sent as 8-bit signed integer values relative to a constant reference value of 2^(BPP–1). -
    • -
  • In an intra picture, if BPP is 8, the spatial-domain residual difference data blocks for intra macroblocks are sent as 8-bit signed integer values relative to a constant reference value of 2^(BPP–1), regardless of the value of ConfigSpatialResid8. -
    • -
-If ConfigResidDiffHost is 1 and ConfigIntraResidUnsigned is 1, spatial-domain residual difference data blocks for intra macroblocks must be sent as follows: - + If ConfigResidDiffHost is 1 and ConfigIntraResidUnsigned is 0, spatial-domain residual difference data blocks for intra macroblocks must be sent as follows: -
    -
  • In a non-intra picture, if ConfigSpatialResid8 is 0, the spatial-domain residual difference data blocks for intra macroblocks must be sent as 16-bit unsigned integer values relative to a constant reference value of 0. -
    • -
  • In a non-intra picture, if ConfigSpatialResid8 is 1, the spatial-domain residual difference data blocks for intra macroblocks are sent as 8-bit unsigned integer values relative to a constant reference value of 0. -
    • -
  • In an intra picture, if BPP is 8, the spatial-domain residual difference data blocks for intra macroblocks are sent as 8-bit unsigned integer values relative to a constant reference value of 0, regardless of the value of ConfigSpatialResid8. -
    • -
-The value of the member must be 0 unless ConfigResidDiffHost is 1. + +
    +
  • + In a non-intra picture, if ConfigSpatialResid8 is 0, the spatial-domain residual difference data blocks for intra macroblocks are sent as 16-bit signed integer values relative to a constant reference value of 2^(BPP–1). +
    • +
  • + In a non-intra picture, if ConfigSpatialResid8 is 1, the spatial-domain residual difference data blocks for intra macroblocks are sent as 8-bit signed integer values relative to a constant reference value of 2^(BPP–1). +
    • +
  • + In an intra picture, if BPP is 8, the spatial-domain residual difference data blocks for intra macroblocks are sent as 8-bit signed integer values relative to a constant reference value of 2^(BPP–1), regardless of the value of ConfigSpatialResid8. +
    • +
+ If ConfigResidDiffHost is 1 and ConfigIntraResidUnsigned is 1, spatial-domain residual difference data blocks for intra macroblocks must be sent as follows: + + +
    +
  • + In a non-intra picture, if ConfigSpatialResid8 is 0, the spatial-domain residual difference data blocks for intra macroblocks must be sent as 16-bit unsigned integer values relative to a constant reference value of 0. +
    • +
  • + In a non-intra picture, if ConfigSpatialResid8 is 1, the spatial-domain residual difference data blocks for intra macroblocks are sent as 8-bit unsigned integer values relative to a constant reference value of 0. +
    • +
  • + In an intra picture, if BPP is 8, the spatial-domain residual difference data blocks for intra macroblocks are sent as 8-bit unsigned integer values relative to a constant reference value of 0, regardless of the value of ConfigSpatialResid8. +
    • +
+ The value of the member must be 0 unless ConfigResidDiffHost is 1. + - If the value is 1, transform-domain blocks of coefficient data may be sent from the host for accelerator-based IDCT. If the value is 0, accelerator-based IDCT will not be used. If both ConfigResidDiffHost and ConfigResidDiffAccelerator are 1, this indicates that some residual difference decoding will be done on the host and some on the accelerator, as indicated by macroblock-level control commands. - + + If the value is 1, transform-domain blocks of coefficient data may be sent from the host for accelerator-based IDCT. If the value is 0, accelerator-based IDCT will not be used. If both ConfigResidDiffHost and ConfigResidDiffAccelerator are 1, this indicates that some residual difference decoding will be done on the host and some on the accelerator, as indicated by macroblock-level control commands. -The value must be 0 if ConfigBitstreamRaw is 1. + + The value must be 0 if ConfigBitstreamRaw is 1. + - If the value is 1, the inverse scan for transform-domain block processing will be performed on the host, and absolute indices will be sent instead for any transform coefficients. If the value is 0, the inverse scan will be performed on the accelerator. - + + If the value is 1, the inverse scan for transform-domain block processing will be performed on the host, and absolute indices will be sent instead for any transform coefficients. If the value is 0, the inverse scan will be performed on the accelerator. -The value must be 0 if ConfigResidDiffAccelerator is 0 or if Config4GroupedCoefs is 1. + + The value must be 0 if ConfigResidDiffAccelerator is 0 or if Config4GroupedCoefs is 1. + - If the value is 1, the IDCT specified in Annex W of ITU-T Recommendation H.263 is used. If the value is 0, any compliant IDCT can be used for off-host IDCT. - + + If the value is 1, the IDCT specified in Annex W of ITU-T Recommendation H.263 is used. If the value is 0, any compliant IDCT can be used for off-host IDCT. -The H.263 annex does not comply with the IDCT requirements of MPEG-2 corrigendum 2, so the value must not be 1 for use with MPEG-2 video. - -The value must be 0 if ConfigResidDiffAccelerator is 0, indicating purely host-based residual difference decoding. + The H.263 annex does not comply with the IDCT requirements of MPEG-2 corrigendum 2, so the value must not be 1 for use with MPEG-2 video. + + + The value must be 0 if ConfigResidDiffAccelerator is 0, indicating purely host-based residual difference decoding. + - If the value is 1, transform coefficients for off-host IDCT will be sent using the DXVA_TCoef4Group structure. If the value is 0, the DXVA_TCoefSingle structure is used. The value must be 0 if ConfigResidDiffAccelerator is 0 or if ConfigHostInverseScan is 1. + + If the value is 1, transform coefficients for off-host IDCT will be sent using the DXVA_TCoef4Group structure. If the value is 0, the DXVA_TCoefSingle structure is used. The value must be 0 if ConfigResidDiffAccelerator is 0 or if ConfigHostInverseScan is 1. + Specifies how many frames the decoder device processes at any one time. @@ -6138,7 +8489,9 @@ The value must be 0 if ConfigResidDiffAccelerator is 0, indicating purely Identifies a texture resource for a video processor output view. - Microsoft Docs: + + Microsoft Docs: + @@ -6153,7 +8506,9 @@ The value must be 0 if ConfigResidDiffAccelerator is 0, indicating purely Describes an HLSL class instance. - Microsoft Docs: + + Microsoft Docs: + @@ -6183,7 +8538,9 @@ The value must be 0 if ConfigResidDiffAccelerator is 0, indicating purely Describes an instance of a domain shader to trace. - Microsoft Docs: + + Microsoft Docs: + @@ -6192,84 +8549,124 @@ The value must be 0 if ConfigResidDiffAccelerator is 0, indicating purely Sets the HDR metadata describing the display on which the content will be presented. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + The type of HDR metadata supplied. - The size of the HDR metadata supplied in pHDRMetaData. + + The size of the HDR metadata supplied in pHDRMetaData. -For DXGI_HDR_METADATA_TYPE_NONE, the size should be 0. + For DXGI_HDR_METADATA_TYPE_NONE, the size should be 0. -For DXGI_HDR_METADATA_TYPE_HDR10, the size is sizeof(DXGI_HDR_METADATA_HDR10). - Pointer to the metadata information. + For DXGI_HDR_METADATA_TYPE_HDR10, the size is sizeof(DXGI_HDR_METADATA_HDR10). + + + Pointer to the metadata information. -For DXGI_HDR_METADATA_TYPE_NONE, this should be NULL. + For DXGI_HDR_METADATA_TYPE_NONE, this should be NULL. -For DXGI_HDR_METADATA_TYPE_HDR10, this is a pointer to a DXGI_HDR_METADATA_HDR10 structure. + For DXGI_HDR_METADATA_TYPE_HDR10, this is a pointer to a DXGI_HDR_METADATA_HDR10 structure. + Indicates whether a variable is of the specified type. - Microsoft Docs: - A pointer to a ID3D11ShaderReflectionType Interface. + + Microsoft Docs: + + + A pointer to a ID3D11ShaderReflectionType Interface. + Gets the properties of the video processor output view. - Microsoft Docs: - A pointer to a D3D11_VIDEO_PROCESSOR_OUTPUT_VIEW_DESC structure. The method fills the structure with the view properties. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_PROCESSOR_OUTPUT_VIEW_DESC structure. The method fills the structure with the view properties. + Gets the HDR metadata describing the display on which the content will be presented. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + The type of HDR metadata supplied. - The size of the memory referenced by pHDRMetaData. + + The size of the memory referenced by pHDRMetaData. -If pHDRMetaData is NULL, Size should be 0. - Pointer to a buffer that receives the HDR metadata. + If pHDRMetaData is NULL, Size should be 0. + + + Pointer to a buffer that receives the HDR metadata. -This parameter can be NULL. + This parameter can be NULL. + Gets a description of how a resource is bound to a function. - Microsoft Docs: + + Microsoft Docs: + The constant-buffer name of the resource. - A pointer to a D3D11_SHADER_INPUT_BIND_DESC structure that describes input binding of the resource. + + A pointer to a D3D11_SHADER_INPUT_BIND_DESC structure that describes input binding of the resource. + Provides data to the ID3D11VideoContext::DecoderBeginFrame method. - Microsoft Docs: + + Microsoft Docs: + - A pointer to the ID3D11CryptoSession interface. To get this pointer, call ID3D11VideoDevice1::CreateCryptoSession. + + A pointer to the ID3D11CryptoSession interface. To get this pointer, call ID3D11VideoDevice1::CreateCryptoSession. + - The size of the memory buffer referenced by the pBlob member. + + The size of the memory buffer referenced by the pBlob member. + - The definition of this buffer is dependent on the implementation of the secure execution environment. It could contain a sealed key blob or any other per-key data that the secure execution environment needs to pass to the decode API. + + The definition of this buffer is dependent on the implementation of the secure execution environment. It could contain a sealed key blob or any other per-key data that the secure execution environment needs to pass to the decode API. -The definition of this buffer is dependent on the implementation of the secure environment. It may contain data specific to the current frame. + The definition of this buffer is dependent on the implementation of the secure environment. It may contain data specific to the current frame. + A pointer to a GUID identifying the hardware key. - The size of the memory buffer referenced by the pPrivateData member. + + The size of the memory buffer referenced by the pPrivateData member. + Unordered-access view options. - Microsoft Docs: + + Microsoft Docs: + @@ -6296,25 +8693,41 @@ The definition of this buffer is dependent on the implementation of the secure e Gets the color space for an input stream of the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Receives a D3D11_VIDEO_PROCESSOR_COLOR_SPACE value that specifies the color space. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Receives a D3D11_VIDEO_PROCESSOR_COLOR_SPACE value that specifies the color space. + Submits one or more buffers for decoding. - Microsoft Docs: - A pointer to the ID3D11VideoDecoder interface. To get this pointer, call the ID3D11VideoDevice::CreateVideoDecoder method. + + Microsoft Docs: + + + A pointer to the ID3D11VideoDecoder interface. To get this pointer, call the ID3D11VideoDevice::CreateVideoDecoder method. + The number of buffers submitted for decoding. - A pointer to an array of D3D11_VIDEO_DECODER_BUFFER_DESC structures. The NumBuffers parameter specifies the number of elements in the array. Each element in the array describes a compressed buffer for decoding. + + A pointer to an array of D3D11_VIDEO_DECODER_BUFFER_DESC structures. The NumBuffers parameter specifies the number of elements in the array. Each element in the array describes a compressed buffer for decoding. + Identifies a shader type for tracing. - Microsoft Docs: + + Microsoft Docs: + @@ -6338,129 +8751,193 @@ The definition of this buffer is dependent on the implementation of the secure e Get a shader-reflection variable by index. - Microsoft Docs: + + Microsoft Docs: + Zero-based index. Direct3D 11 feature options. - Microsoft Docs: + + Microsoft Docs: + - The driver supports multithreading. To see an example of testing a driver for multithread support, see How To: Check for Driver Support. Refer to D3D11_FEATURE_DATA_THREADING. + + The driver supports multithreading. To see an example of testing a driver for multithread support, see How To: Check for Driver Support. Refer to D3D11_FEATURE_DATA_THREADING. + - Supports the use of the double-precision shaders in HLSL. Refer to D3D11_FEATURE_DATA_DOUBLES. + + Supports the use of the double-precision shaders in HLSL. Refer to D3D11_FEATURE_DATA_DOUBLES. + - Supports the formats in D3D11_FORMAT_SUPPORT. Refer to D3D11_FEATURE_DATA_FORMAT_SUPPORT. + + Supports the formats in D3D11_FORMAT_SUPPORT. Refer to D3D11_FEATURE_DATA_FORMAT_SUPPORT. + - Supports the formats in D3D11_FORMAT_SUPPORT2. Refer to D3D11_FEATURE_DATA_FORMAT_SUPPORT2. + + Supports the formats in D3D11_FORMAT_SUPPORT2. Refer to D3D11_FEATURE_DATA_FORMAT_SUPPORT2. + - Supports compute shaders and raw and structured buffers. Refer to D3D11_FEATURE_DATA_D3D10_X_HARDWARE_OPTIONS. + + Supports compute shaders and raw and structured buffers. Refer to D3D11_FEATURE_DATA_D3D10_X_HARDWARE_OPTIONS. + - Supports Direct3D 11.1 feature options. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS. + + Supports Direct3D 11.1 feature options. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Supports specific adapter architecture. Refer to D3D11_FEATURE_DATA_ARCHITECTURE_INFO. + + Supports specific adapter architecture. Refer to D3D11_FEATURE_DATA_ARCHITECTURE_INFO. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Supports Direct3D 9 feature options. Refer to D3D11_FEATURE_DATA_D3D9_OPTIONS. + + Supports Direct3D 9 feature options. Refer to D3D11_FEATURE_DATA_D3D9_OPTIONS. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Supports minimum precision of shaders. For more info about HLSL minimum precision, see using HLSL minimum precision. Refer to D3D11_FEATURE_DATA_SHADER_MIN_PRECISION_SUPPORT. + + Supports minimum precision of shaders. For more info about HLSL minimum precision, see using HLSL minimum precision. Refer to D3D11_FEATURE_DATA_SHADER_MIN_PRECISION_SUPPORT. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Supports Direct3D 9 shadowing feature. Refer to D3D11_FEATURE_DATA_D3D9_SHADOW_SUPPORT. + + Supports Direct3D 9 shadowing feature. Refer to D3D11_FEATURE_DATA_D3D9_SHADOW_SUPPORT. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + - Supports Direct3D 11.2 feature options. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS1. + + Supports Direct3D 11.2 feature options. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS1. -Direct3D 11:  This value is not supported until Direct3D 11.2. + Direct3D 11:  This value is not supported until Direct3D 11.2. + - Supports Direct3D 11.2 instancing options. Refer to D3D11_FEATURE_DATA_D3D9_SIMPLE_INSTANCING_SUPPORT. + + Supports Direct3D 11.2 instancing options. Refer to D3D11_FEATURE_DATA_D3D9_SIMPLE_INSTANCING_SUPPORT. -Direct3D 11:  This value is not supported until Direct3D 11.2. + Direct3D 11:  This value is not supported until Direct3D 11.2. + - Supports Direct3D 11.2 marker options. Refer to D3D11_FEATURE_DATA_MARKER_SUPPORT. + + Supports Direct3D 11.2 marker options. Refer to D3D11_FEATURE_DATA_MARKER_SUPPORT. -Direct3D 11:  This value is not supported until Direct3D 11.2. + Direct3D 11:  This value is not supported until Direct3D 11.2. + - Supports Direct3D 9 feature options, which includes the Direct3D 9 shadowing feature and instancing support. Refer to D3D11_FEATURE_DATA_D3D9_OPTIONS1. + + Supports Direct3D 9 feature options, which includes the Direct3D 9 shadowing feature and instancing support. Refer to D3D11_FEATURE_DATA_D3D9_OPTIONS1. -Direct3D 11:  This value is not supported until Direct3D 11.2. + Direct3D 11:  This value is not supported until Direct3D 11.2. + - Supports Direct3D 11.3 conservative rasterization feature options. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS2. + + Supports Direct3D 11.3 conservative rasterization feature options. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS2. -Direct3D 11:  This value is not supported until Direct3D 11.3. + Direct3D 11:  This value is not supported until Direct3D 11.3. + - Supports Direct3D 11.4 conservative rasterization feature options. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS3. + + Supports Direct3D 11.4 conservative rasterization feature options. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS3. -Direct3D 11:  This value is not supported until Direct3D 11.4. + Direct3D 11:  This value is not supported until Direct3D 11.4. + - Supports GPU virtual addresses. Refer to D3D11_FEATURE_DATA_GPU_VIRTUAL_ADDRESS_SUPPORT. + + Supports GPU virtual addresses. Refer to D3D11_FEATURE_DATA_GPU_VIRTUAL_ADDRESS_SUPPORT. + - Supports a single boolean for NV12 shared textures. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS4. + + Supports a single boolean for NV12 shared textures. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS4. -Direct3D 11:  This value is not supported until Direct3D 11.4. + Direct3D 11:  This value is not supported until Direct3D 11.4. + - Supports shader cache, described in D3D11_FEATURE_DATA_SHADER_CACHE. + + Supports shader cache, described in D3D11_FEATURE_DATA_SHADER_CACHE. + - Supports a D3D11_SHARED_RESOURCE_TIER to indicate a tier for shared resource support. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS5. + + Supports a D3D11_SHARED_RESOURCE_TIER to indicate a tier for shared resource support. Refer to D3D11_FEATURE_DATA_D3D11_OPTIONS5. + Gets the instance name of the current HLSL class. - Microsoft Docs: + + Microsoft Docs: + The instance name of the current HLSL class. - The length of the pInstanceName parameter. + + The length of the pInstanceName parameter. + Copy the entire contents of the source resource to the destination resource using the GPU. - Microsoft Docs: - A pointer to the ID3D11Resource interface that represents the destination resource. - A pointer to the ID3D11Resource interface that represents the source resource. + + Microsoft Docs: + + + A pointer to the ID3D11Resource interface that represents the destination resource. + + + A pointer to the ID3D11Resource interface that represents the source resource. + Creates a resource view for a video decoder, describing the output sample for the decoding operation. - Microsoft Docs: - A pointer to the ID3D11Resource interface of the decoder surface. The resource must be created with the D3D11_BIND_DECODER flag. See D3D11_BIND_FLAG. - A pointer to a D3D11_VIDEO_DECODER_OUTPUT_VIEW_DESC structure that describes the view. - Receives a pointer to the ID3D11VideoDecoderOutputView interface. The caller must release the interface. If this parameter is NULL, the method checks whether the view is supported, but does not create the view. + + Microsoft Docs: + + + A pointer to the ID3D11Resource interface of the decoder surface. The resource must be created with the D3D11_BIND_DECODER flag. See D3D11_BIND_FLAG. + + + A pointer to a D3D11_VIDEO_DECODER_OUTPUT_VIEW_DESC structure that describes the view. + + + Receives a pointer to the ID3D11VideoDecoderOutputView interface. The caller must release the interface. If this parameter is NULL, the method checks whether the view is supported, but does not create the view. + Describes a tiled subresource volume. - Microsoft Docs: + + Microsoft Docs: + @@ -6473,180 +8950,246 @@ The definition of this buffer is dependent on the implementation of the secure e The depth in tiles of the subresource. - The index of the tile in the overall tiled subresource to start with. + + The index of the tile in the overall tiled subresource to start with. -GetResourceTiling sets StartTileIndexInOverallResource to D3D11_PACKED_TILE (0xffffffff) to indicate that the whole -D3D11_SUBRESOURCE_TILING structure is meaningless, and the info to which the pPackedMipDesc parameter of GetResourceTiling points applies. For packed tiles, the description of the packed mipmaps comes from a D3D11_PACKED_MIP_DESC structure instead. + GetResourceTiling sets StartTileIndexInOverallResource to D3D11_PACKED_TILE (0xffffffff) to indicate that the whole + D3D11_SUBRESOURCE_TILING structure is meaningless, and the info to which the pPackedMipDesc parameter of GetResourceTiling points applies. For packed tiles, the description of the packed mipmaps comes from a D3D11_PACKED_MIP_DESC structure instead. + Describes a trace register. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_TRACE_REGISTER_TYPE-typed value that identifies the type of register that the shader-trace object uses. + + A D3D11_TRACE_REGISTER_TYPE-typed value that identifies the type of register that the shader-trace object uses. + - An index for one-dimensional arrays. This index is used by the following register types: + + An index for one-dimensional arrays. This index is used by the following register types: -
    -
  • vertex shader or pixel shader input: v[Index1D]
    • -
  • temp: r[Index1D]
    • -
  • output: o[Index1D]
    • -
  • immediate constant buffer: icb[Index1D]
    • -
  • sampler s[Index1D]
    • -
  • resource r[Index1D]
    • -
  • input patch constant register: vpc[Index1D]
    • -
  • unordered access view: u[Index1D]
    • -
  • thread group shared memory: g[Index1D]
    • -
 +
    +
  • vertex shader or pixel shader input: v[Index1D]
    • +
  • temp: r[Index1D]
    • +
  • output: o[Index1D]
    • +
  • immediate constant buffer: icb[Index1D]
    • +
  • sampler s[Index1D]
    • +
  • resource r[Index1D]
    • +
  • input patch constant register: vpc[Index1D]
    • +
  • unordered access view: u[Index1D]
    • +
  • thread group shared memory: g[Index1D]
    • +
+ - An array of indexes for two-dimensional arrays. These indexes are used by the following register types: + + An array of indexes for two-dimensional arrays. These indexes are used by the following register types: -
    -
  • GS input: v[Index2D[0]][Index2D[1]]
    • -
  • indexable temp: x[Index2D[0]][Index2D[1]]
    • -
  • constant buffer: cb#[#]
    • -
  • input control point register: vcp[Index2D[0]][Index2D[1]]
    • -
  • output control point register: vocp[Index2D[0]][Index2D[1]]
    • -
 +
    +
  • GS input: v[Index2D[0]][Index2D[1]]
    • +
  • indexable temp: x[Index2D[0]][Index2D[1]]
    • +
  • constant buffer: cb#[#]
    • +
  • input control point register: vcp[Index2D[0]][Index2D[1]]
    • +
  • output control point register: vocp[Index2D[0]][Index2D[1]]
    • +
+ The index of the operand, which starts from 0. - A combination of the following flags that are combined by using a bitwise OR operation. The resulting value specifies more about the trace register. + + A combination of the following flags that are combined by using a bitwise OR operation. The resulting value specifies more about the trace register. - - - - - - - - - -
FlagDescription
D3D11_TRACE_REGISTER_FLAGS_RELATIVE_INDEXING (0x1)Access to the register is part of the relative indexing of a register.
 + + + + + + + + + +
FlagDescription
D3D11_TRACE_REGISTER_FLAGS_RELATIVE_INDEXING (0x1)Access to the register is part of the relative indexing of a register.
+ Get a shader-reflection variable by name. - Microsoft Docs: + + Microsoft Docs: + Variable name. Get the flags used during the call to create the device with D3D11CreateDevice. - Microsoft Docs: + + Microsoft Docs: + Gets the properties of a render-target view. - Microsoft Docs: - A pointer to a D3D11_RENDER_TARGET_VIEW_DESC1 structure that receives the description of the render-target view. + + Microsoft Docs: + + + A pointer to a D3D11_RENDER_TARGET_VIEW_DESC1 structure that receives the description of the render-target view. + Creates a render-target view for accessing resource data. - Microsoft Docs: - Pointer to a ID3D11Resource that represents a render target. This resource must have been created with the D3D11_BIND_RENDER_TARGET flag. - Pointer to a D3D11_RENDER_TARGET_VIEW_DESC that represents a render-target view description. Set this parameter to NULL to create a view that accesses all of the subresources in mipmap level 0. - Address of a pointer to an ID3D11RenderTargetView. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + + Microsoft Docs: + + + Pointer to a ID3D11Resource that represents a render target. This resource must have been created with the D3D11_BIND_RENDER_TARGET flag. + + + Pointer to a D3D11_RENDER_TARGET_VIEW_DESC that represents a render-target view description. Set this parameter to NULL to create a view that accesses all of the subresources in mipmap level 0. + + + Address of a pointer to an ID3D11RenderTargetView. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Set the number of milliseconds to sleep after IDXGISwapChain::Present is called. - Microsoft Docs: + + Microsoft Docs: + Number of milliseconds to sleep after Present is called. Creates a call-function linking node to use in the function-linking-graph. - Microsoft Docs: - The optional namespace for the function, or NULL if no namespace is needed. - A pointer to the ID3D11ModuleInstance interface for the library module that contains the function prototype. + + Microsoft Docs: + + + The optional namespace for the function, or NULL if no namespace is needed. + + + A pointer to the ID3D11ModuleInstance interface for the library module that contains the function prototype. + The name of the function. - A pointer to a variable that receives a pointer to the ID3D11LinkingNode interface that represents the function in the function-linking-graph. + + A pointer to a variable that receives a pointer to the ID3D11LinkingNode interface that represents the function in the function-linking-graph. + Gets an ID3D11ShaderReflectionType Interface interface containing the variable base class type. - Microsoft Docs: + + Microsoft Docs: + Creates a context state object that holds all Microsoft Direct3D state and some Direct3D behavior. - Microsoft Docs: - A combination of - D3D11_1_CREATE_DEVICE_CONTEXT_STATE_FLAG - values that are combined by using a bitwise OR operation. - The resulting value specifies how to create the context state object. - The - D3D11_1_CREATE_DEVICE_CONTEXT_STATE_SINGLETHREADEDflag is currently the only defined flag. - If the original device was created with - D3D11_CREATE_DEVICE_SINGLETHREADED, - you must create all context state objects from that device with the - D3D11_1_CREATE_DEVICE_CONTEXT_STATE_SINGLETHREADEDflag. - + + Microsoft Docs: + + + A combination of + D3D11_1_CREATE_DEVICE_CONTEXT_STATE_FLAG + values that are combined by using a bitwise OR operation. + The resulting value specifies how to create the context state object. + The + D3D11_1_CREATE_DEVICE_CONTEXT_STATE_SINGLETHREADEDflag is currently the only defined flag. + If the original device was created with + D3D11_CREATE_DEVICE_SINGLETHREADED, + you must create all context state objects from that device with the + D3D11_1_CREATE_DEVICE_CONTEXT_STATE_SINGLETHREADEDflag. -If you set the single-threaded flag for both the context state object and the device, you guarantee that you will call the whole set of context methods and device methods only from one thread. - You therefore do not need to use critical sections to synchronize access to the device context, and the runtime can avoid working with those processor-intensive critical sections. - A pointer to an array of D3D_FEATURE_LEVEL values. The array can contain elements from the following list and determines the order of feature levels for which creation is attempted. - Unlike D3D11CreateDevice, you can't set pFeatureLevels to NULL because there is no default feature level array. - + + If you set the single-threaded flag for both the context state object and the device, you guarantee that you will call the whole set of context methods and device methods only from one thread. + You therefore do not need to use critical sections to synchronize access to the device context, and the runtime can avoid working with those processor-intensive critical sections. + + + A pointer to an array of D3D_FEATURE_LEVEL values. The array can contain elements from the following list and determines the order of feature levels for which creation is attempted. + Unlike D3D11CreateDevice, you can't set pFeatureLevels to NULL because there is no default feature level array. - -{ - D3D_FEATURE_LEVEL_11_1, - D3D_FEATURE_LEVEL_11_0, - D3D_FEATURE_LEVEL_10_1, - D3D_FEATURE_LEVEL_10_0, - D3D_FEATURE_LEVEL_9_3, - D3D_FEATURE_LEVEL_9_2, - D3D_FEATURE_LEVEL_9_1, -}; - - - The number of elements in pFeatureLevels. Unlike D3D11CreateDevice, you must set FeatureLevels to greater than 0 because you can't set pFeatureLevels to NULL. - The SDK version. You must set this parameter to D3D11_SDK_VERSION. - The globally unique identifier (GUID) for the emulated interface. This value specifies the behavior of the device when the context state object is active. Valid values are obtained by using the __uuidof operator on the ID3D10Device, ID3D10Device1, ID3D11Device, and ID3D11Device1 interfaces. See Remarks. - A pointer to a variable that receives a D3D_FEATURE_LEVEL value from the pFeatureLevels array. This is the first array value with which CreateDeviceContextState succeeded in creating the context state object. If the call to CreateDeviceContextState fails, the variable pointed to by pChosenFeatureLevel is set to zero. - The address of a pointer to an ID3DDeviceContextState object that represents the state of a Direct3D device. + + + { + D3D_FEATURE_LEVEL_11_1, + D3D_FEATURE_LEVEL_11_0, + D3D_FEATURE_LEVEL_10_1, + D3D_FEATURE_LEVEL_10_0, + D3D_FEATURE_LEVEL_9_3, + D3D_FEATURE_LEVEL_9_2, + D3D_FEATURE_LEVEL_9_1, + }; + + + + + The number of elements in pFeatureLevels. Unlike D3D11CreateDevice, you must set FeatureLevels to greater than 0 because you can't set pFeatureLevels to NULL. + + + The SDK version. You must set this parameter to D3D11_SDK_VERSION. + + + The globally unique identifier (GUID) for the emulated interface. This value specifies the behavior of the device when the context state object is active. Valid values are obtained by using the __uuidof operator on the ID3D10Device, ID3D10Device1, ID3D11Device, and ID3D11Device1 interfaces. See Remarks. + + + A pointer to a variable that receives a D3D_FEATURE_LEVEL value from the pFeatureLevels array. This is the first array value with which CreateDeviceContextState succeeded in creating the context state object. If the call to CreateDeviceContextState fails, the variable pointed to by pChosenFeatureLevel is set to zero. + + + The address of a pointer to an ID3DDeviceContextState object that represents the state of a Direct3D device. + Allows applications to annotate the end of a range of graphics commands. - Microsoft Docs: + + Microsoft Docs: + Contains a response from the ID3D11VideoContext::QueryAuthenticatedChannel method. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_OMAC structure that contains a Message Authentication Code (MAC) of the data. The driver uses AESbased one-key CBC MAC (OMAC) to calculate this value for the block of data that appears after this structure member. + + A D3D11_OMAC structure that contains a Message Authentication Code (MAC) of the data. The driver uses AESbased one-key CBC MAC (OMAC) to calculate this value for the block of data that appears after this structure member. + - A GUID that specifies the query. For a list of possible values, see D3D11_AUTHENTICATED_QUERY_INPUT + + A GUID that specifies the query. For a list of possible values, see D3D11_AUTHENTICATED_QUERY_INPUT + - A handle to the authenticated channel. To get the handle, call the ID3D11AuthenticatedChannel::GetChannelHandle method. + + A handle to the authenticated channel. To get the handle, call the ID3D11AuthenticatedChannel::GetChannelHandle method. + The query sequence number. @@ -6657,35 +9200,49 @@ If you set the single-threaded flag for both the context state object and the de Get the shader resource view's description. - Microsoft Docs: - A pointer to a D3D11_SHADER_RESOURCE_VIEW_DESC structure to be filled with data about the shader resource view. + + Microsoft Docs: + + + A pointer to a D3D11_SHADER_RESOURCE_VIEW_DESC structure to be filled with data about the shader resource view. + The default tracking interface sets reference default tracking options. - Microsoft Docs: + + Microsoft Docs: + Bind an array of shader resources to the domain-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting shader resources to (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). Number of shader resources to set. Up to a maximum of 128 slots are available for shader resources(ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to set to the device. + + Array of shader resource view interfaces to set to the device. + A module interface creates an instance of a module that is used for resource rebinding. - Microsoft Docs: + + Microsoft Docs: + Identifies a texture resource for a video processor output view. - Microsoft Docs: + + Microsoft Docs: + @@ -6694,24 +9251,40 @@ If you set the single-threaded flag for both the context state object and the de Initializes an instance of a shader module that is used for resource rebinding. - Microsoft Docs: - The name of a shader module to initialize. This can be NULL if you don't want to specify a name for the module. - The address of a pointer to an ID3D11ModuleInstance interface to initialize. + + Microsoft Docs: + + + The name of a shader module to initialize. This can be NULL if you don't want to specify a name for the module. + + + The address of a pointer to an ID3D11ModuleInstance interface to initialize. + Given aprofile, checks whether the driver supports a specified output format. - Microsoft Docs: - A pointer to a GUID that identifies the profile. To get the list of supported profiles, call ID3D11VideoDevice::GetVideoDecoderProfile. - A DXGI_FORMAT value that specifies the output format. Typical values include DXGI_FORMAT_NV12 and DXGI_FORMAT_420_OPAQUE. - Receives the value TRUE if the format is supported, or FALSE otherwise. + + Microsoft Docs: + + + A pointer to a GUID that identifies the profile. To get the list of supported profiles, call ID3D11VideoDevice::GetVideoDecoderProfile. + + + A DXGI_FORMAT value that specifies the output format. Typical values include DXGI_FORMAT_NV12 and DXGI_FORMAT_420_OPAQUE. + + + Receives the value TRUE if the format is supported, or FALSE otherwise. + Options that specify how to perform shader debug tracking. - Microsoft Docs: + + Microsoft Docs: + @@ -6757,62 +9330,92 @@ If you set the single-threaded flag for both the context state object and the de Track all hazards and track that hazards are allowed in which data is written but the value does not change. - All of the preceding tracking options are set except D3D11_SHADER_TRACKING_OPTION_IGNORE. + + All of the preceding tracking options are set except D3D11_SHADER_TRACKING_OPTION_IGNORE. + Creates an array of 1D textures. - Microsoft Docs: - A pointer to a D3D11_TEXTURE1D_DESC structure that describes a 1D texture resource. To create a typeless resource that can be interpreted at runtime into different, compatible formats, specify a typeless format in the texture description. To generate mipmap levels automatically, set the number of mipmap levels to 0. - A pointer to an array of D3D11_SUBRESOURCE_DATA structures that describe subresources for the 1D texture resource. Applications can't specify NULL for pInitialData when creating IMMUTABLE resources (see D3D11_USAGE). If the resource is multisampled, pInitialData must be NULL because multisampled resources cannot be initialized with data when they are created. + + Microsoft Docs: + + + A pointer to a D3D11_TEXTURE1D_DESC structure that describes a 1D texture resource. To create a typeless resource that can be interpreted at runtime into different, compatible formats, specify a typeless format in the texture description. To generate mipmap levels automatically, set the number of mipmap levels to 0. + + + A pointer to an array of D3D11_SUBRESOURCE_DATA structures that describe subresources for the 1D texture resource. Applications can't specify NULL for pInitialData when creating IMMUTABLE resources (see D3D11_USAGE). If the resource is multisampled, pInitialData must be NULL because multisampled resources cannot be initialized with data when they are created. -If you don't pass anything to pInitialData, the initial content of the memory for the resource is undefined. In this case, you need to write the resource content some other way before the resource is read. + If you don't pass anything to pInitialData, the initial content of the memory for the resource is undefined. In this case, you need to write the resource content some other way before the resource is read. -You can determine the size of this array from values in the MipLevels and ArraySize members of the D3D11_TEXTURE1D_DESC structure to which pDesc points by using the following calculation: + You can determine the size of this array from values in the MipLevels and ArraySize members of the D3D11_TEXTURE1D_DESC structure to which pDesc points by using the following calculation: -MipLevels * ArraySize + MipLevels * ArraySize -For more information about this array size, see Remarks. - A pointer to a buffer that receives a pointer to a ID3D11Texture1D interface for the created texture. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + For more information about this array size, see Remarks. + + + A pointer to a buffer that receives a pointer to a ID3D11Texture1D interface for the created texture. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Create a geometry shader. - Microsoft Docs: + + Microsoft Docs: + A pointer to the compiled shader. Size of the compiled geometry shader. - A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. - Address of a pointer to a ID3D11GeometryShader interface. If this is NULL, all other parameters will be validated, and if all - parameters pass validation this API will return S_FALSE instead of S_OK. + + A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. + + + Address of a pointer to a ID3D11GeometryShader interface. If this is NULL, all other parameters will be validated, and if all + parameters pass validation this API will return S_FALSE instead of S_OK. + This method returns the buffer of the current ID3D11ShaderReflectionVariable. - Microsoft Docs: + + Microsoft Docs: + Gets a handle to the cryptographic session. - Microsoft Docs: + + Microsoft Docs: + Receives a handle to the session. Sets the constant buffers used by the compute-shader stage. - Microsoft Docs: - Index into the zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffers (see ID3D11Buffer) being given to the device. + + Microsoft Docs: + + + Index into the zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). + + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + + Array of constant buffers (see ID3D11Buffer) being given to the device. + For stereo 3D video, specifies whether the data in frame 0 or frame 1 is flipped, either horizontally or vertically. - Microsoft Docs: + + Microsoft Docs: + @@ -6827,99 +9430,132 @@ For more information about this array size, see Remarks. Contains input data for the ID3D11VideoContext::ConfigureAuthenticatedChannel method. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_OMAC structure that contains a Message Authentication Code (MAC) of the data. The driver uses AES-based one-key CBC MAC (OMAC) to calculate this value for the block of data that appears after this structure member. + + A D3D11_OMAC structure that contains a Message Authentication Code (MAC) of the data. The driver uses AES-based one-key CBC MAC (OMAC) to calculate this value for the block of data that appears after this structure member. + - A GUID that specifies the command. The following GUIDs are defined. + + A GUID that specifies the command. The following GUIDs are defined. - - - - - - - - + +
ValueMeaning
-
D3D11_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION
-
-		 -Associates a cryptographic session with a decoder device and a Direct3D device. + + + + + + + + - - - - + + + + - - - - + + + + - - - - + + + + - - - - + + + + - -
ValueMeaning
+ + +
+
+ D3D11_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION +
+
+ 		+ Associates a cryptographic session with a decoder device and a Direct3D device. -Input data: D3D11_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION_INPUT + Input data: D3D11_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION_INPUT -
-
D3D11_AUTHENTICATED_CONFIGURE_ENCRYPTION_WHEN_ACCESSIBLE
-
-		 -Sets the level of encryption that is performed before protected content becomes accessible to the CPU or bus. +
+ + +
+
+ D3D11_AUTHENTICATED_CONFIGURE_ENCRYPTION_WHEN_ACCESSIBLE +
+
+ 		+ Sets the level of encryption that is performed before protected content becomes accessible to the CPU or bus. -Input data: D3D11_AUTHENTICATED_CONFIGURE_ACCESSIBLE_ENCRYPTION_INPUT + Input data: D3D11_AUTHENTICATED_CONFIGURE_ACCESSIBLE_ENCRYPTION_INPUT -
-
D3D11_AUTHENTICATED_CONFIGURE_INITIALIZE
-
-		 -Initializes the authenticated channel. +
+ + +
+
+ D3D11_AUTHENTICATED_CONFIGURE_INITIALIZE +
+
+ 		+ Initializes the authenticated channel. -Input data: D3D11_AUTHENTICATED_CONFIGURE_INITIALIZE_INPUT + Input data: D3D11_AUTHENTICATED_CONFIGURE_INITIALIZE_INPUT -
-
D3D11_AUTHENTICATED_CONFIGURE_PROTECTION
-
-		 -Enables or disables protection for the device. +
+ + +
+
+ D3D11_AUTHENTICATED_CONFIGURE_PROTECTION +
+
+ 		+ Enables or disables protection for the device. -Input data: D3D11_AUTHENTICATED_CONFIGURE_PROTECTION_INPUT + Input data: D3D11_AUTHENTICATED_CONFIGURE_PROTECTION_INPUT -
-
D3D11_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE
-
-		 -Enables a process to open a shared resource, or disables a process from opening shared resources. +
+ + +
+
+ D3D11_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE +
+
+ 		+ Enables a process to open a shared resource, or disables a process from opening shared resources. -Input data: D3D11_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE_INPUT + Input data: D3D11_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE_INPUT -
+
+ - A handle to the authenticated channel. To get the handle, call the ID3D11AuthenticatedChannel::GetChannelHandle method. + + A handle to the authenticated channel. To get the handle, call the ID3D11AuthenticatedChannel::GetChannelHandle method. + The query sequence number. At the start of the session, generate a cryptographically secure 32-bit random number to use as the starting sequence number. For each query, increment the sequence number by 1. @@ -6927,7 +9563,9 @@ Input data: Specifies the subresource from a 1D texture to use in a render-target view. - Microsoft Docs: + + Microsoft Docs: + @@ -6936,55 +9574,81 @@ Input data: Specifies capabilities of the video decoder. - Microsoft Docs: + + Microsoft Docs: + Indicates that the graphics driver supports at least a subset of downsampling operations. - Indicates that the decoding hardware cannot support the decode operation in real-time. Decoding is still supported for transcoding scenarios. + + Indicates that the decoding hardware cannot support the decode operation in real-time. Decoding is still supported for transcoding scenarios. -With this capability, it is possible that decoding can occur in real-time if downsampling is enabled. + With this capability, it is possible that decoding can occur in real-time if downsampling is enabled. + - Indicates that the driver supports changing down sample parameters after the initial down sample parameters have been applied. For more information, see ID3D11VideoContext1::DecoderUpdateDownsampling. + + Indicates that the driver supports changing down sample parameters after the initial down sample parameters have been applied. For more information, see ID3D11VideoContext1::DecoderUpdateDownsampling. + Sets the alpha fill mode for data that the video processor writes to the render target. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The alpha fill mode, specified as a D3D11_VIDEO_PROCESSOR_ALPHA_FILL_MODE value. - The zero-based index of an input stream. This parameter is used if AlphaFillMode is D3D11_VIDEO_PROCESSOR_ALPHA_FILL_MODE_SOURCE_STREAM. Otherwise, the parameter is ignored. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The alpha fill mode, specified as a D3D11_VIDEO_PROCESSOR_ALPHA_FILL_MODE value. + + + The zero-based index of an input stream. This parameter is used if AlphaFillMode is D3D11_VIDEO_PROCESSOR_ALPHA_FILL_MODE_SOURCE_STREAM. Otherwise, the parameter is ignored. + Describes compute shader and raw and structured buffer support in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + - TRUE if compute shaders and raw and structured buffers are supported; otherwise FALSE. + + TRUE if compute shaders and raw and structured buffers are supported; otherwise FALSE. + Describes a function parameter. - Microsoft Docs: + + Microsoft Docs: + The name of the function parameter. - The HLSL semantic that is associated with this function parameter. This name includes the index, for example, SV_Target[n]. + + The HLSL semantic that is associated with this function parameter. This name includes the index, for example, SV_Target[n]. + - A D3D_SHADER_VARIABLE_TYPE-typed value that identifies the variable type for the parameter. + + A D3D_SHADER_VARIABLE_TYPE-typed value that identifies the variable type for the parameter. + - A D3D_SHADER_VARIABLE_CLASS-typed value that identifies the variable class for the parameter as one of scalar, vector, matrix, object, and so on. + + A D3D_SHADER_VARIABLE_CLASS-typed value that identifies the variable class for the parameter as one of scalar, vector, matrix, object, and so on. + The number of rows for a matrix parameter. @@ -6993,10 +9657,14 @@ With this capability, it is possible that decoding can occur in real-time if dow The number of columns for a matrix parameter. - A D3D_INTERPOLATION_MODE-typed value that identifies the interpolation mode for the parameter. + + A D3D_INTERPOLATION_MODE-typed value that identifies the interpolation mode for the parameter. + - A combination of D3D_PARAMETER_FLAGS-typed values that are combined by using a bitwise OR operation. The resulting value specifies semantic flags for the parameter. + + A combination of D3D_PARAMETER_FLAGS-typed values that are combined by using a bitwise OR operation. The resulting value specifies semantic flags for the parameter. + The first input register for this parameter. @@ -7013,29 +9681,47 @@ With this capability, it is possible that decoding can occur in real-time if dow Sets the constant buffers that the domain-shader stage uses. - Microsoft Docs: + + Microsoft Docs: + Index into the zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + Array of constant buffers being given to the device. - An array that holds the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. Each offset must be a multiple of 16 constants. - An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + + An array that holds the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. Each offset must be a multiple of 16 constants. + + + An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + Sets a driver-specific state on a video processing stream. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + A pointer to a GUID that identifies the operation. The meaning of this GUID is defined by the graphics driver. - The size of the pData buffer, in bytes. + + The size of the pData buffer, in bytes. + A pointer to a buffer that contains private state data. The method passes this buffer directly to the driver without validation. It is the responsibility of the driver to validate the data. Defines capabilities related to input formats for a Microsoft Direct3D 11 video processor. - Microsoft Docs: + + Microsoft Docs: + @@ -7053,35 +9739,51 @@ With this capability, it is possible that decoding can occur in real-time if dow Describes the blend state that you use in a call to ID3D11Device1::CreateBlendState1 to create a blend-state object. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether to use alpha-to-coverage as a multisampling technique when setting a pixel to a render target. For more info about using alpha-to-coverage, see Alpha-To-Coverage. + + Specifies whether to use alpha-to-coverage as a multisampling technique when setting a pixel to a render target. For more info about using alpha-to-coverage, see Alpha-To-Coverage. + - Specifies whether to enable independent blending in simultaneous render targets. Set to TRUE to enable independent blending. If set to FALSE, only the RenderTarget[0] members are used; RenderTarget[1..7] are ignored. + + Specifies whether to enable independent blending in simultaneous render targets. Set to TRUE to enable independent blending. If set to FALSE, only the RenderTarget[0] members are used; RenderTarget[1..7] are ignored. -See the Remarks section for restrictions. + See the Remarks section for restrictions. + - An array of D3D11_RENDER_TARGET_BLEND_DESC1 structures that describe the blend states for render targets; these correspond to the eight render targets that can be bound to the output-merger stage at one time. + + An array of D3D11_RENDER_TARGET_BLEND_DESC1 structures that describe the blend states for render targets; these correspond to the eight render targets that can be bound to the output-merger stage at one time. + Bind an index buffer to the input-assembler stage. - Microsoft Docs: - A pointer to an ID3D11Buffer object, that contains indices. The index buffer must have been created with - the D3D11_BIND_INDEX_BUFFER flag. - A DXGI_FORMAT that specifies the format of the data in the index buffer. The only formats allowed for index - buffer data are 16-bit (DXGI_FORMAT_R16_UINT) and 32-bit (DXGI_FORMAT_R32_UINT) integers. + + Microsoft Docs: + + + A pointer to an ID3D11Buffer object, that contains indices. The index buffer must have been created with + the D3D11_BIND_INDEX_BUFFER flag. + + + A DXGI_FORMAT that specifies the format of the data in the index buffer. The only formats allowed for index + buffer data are 16-bit (DXGI_FORMAT_R16_UINT) and 32-bit (DXGI_FORMAT_R32_UINT) integers. + Offset (in bytes) from the start of the index buffer to the first index to use. Describes the subresource from a 2D texture to use in a render-target view. - Microsoft Docs: + + Microsoft Docs: + @@ -7093,52 +9795,68 @@ See the Remarks section for restrictions. A description of a single element for the input-assembler stage. - Microsoft Docs: + + Microsoft Docs: + The HLSL semantic associated with this element in a shader input-signature. - The semantic index for the element. A semantic index modifies a semantic, with an integer index number. A semantic index is only needed in a - case where there is more than one element with the same semantic. For example, a 4x4 matrix would have four components each with the semantic - name + + The semantic index for the element. A semantic index modifies a semantic, with an integer index number. A semantic index is only needed in a + case where there is more than one element with the same semantic. For example, a 4x4 matrix would have four components each with the semantic + name - -matrix - + + matrix + -, however each of the four component would have different semantic indices (0, 1, 2, and 3). + , however each of the four component would have different semantic indices (0, 1, 2, and 3). + - The data type of the element data. See DXGI_FORMAT. + + The data type of the element data. See DXGI_FORMAT. + An integer value that identifies the input-assembler (see input slot). Valid values are between 0 and 15, defined in D3D11.h. - Optional. Offset (in bytes) from the start of the vertex. Use D3D11_APPEND_ALIGNED_ELEMENT for convenience to define the current element directly - after the previous one, including any packing if necessary. + + Optional. Offset (in bytes) from the start of the vertex. Use D3D11_APPEND_ALIGNED_ELEMENT for convenience to define the current element directly + after the previous one, including any packing if necessary. + - Identifies the input data class for a single input slot (see D3D11_INPUT_CLASSIFICATION). + + Identifies the input data class for a single input slot (see D3D11_INPUT_CLASSIFICATION). + - The number of instances to draw using the same per-instance data before advancing in the buffer by one element. This value must be 0 for an - element that contains per-vertex data (the slot class is set to D3D11_INPUT_PER_VERTEX_DATA). + + The number of instances to draw using the same per-instance data before advancing in the buffer by one element. This value must be 0 for an + element that contains per-vertex data (the slot class is set to D3D11_INPUT_PER_VERTEX_DATA). + ID3D11SwitchToRef interface - Microsoft Docs: + + Microsoft Docs: + Draw non-indexed, non-instanced primitives. - Microsoft Docs: + + Microsoft Docs: + Number of vertices to draw. Index of the first vertex, which is usually an offset in a vertex buffer. @@ -7146,38 +9864,54 @@ matrix Sends queued-up commands in the command buffer to the graphics processing unit (GPU). - Microsoft Docs: + + Microsoft Docs: + A resource interface provides common actions on all resources. - Microsoft Docs: + + Microsoft Docs: + Set an array of sampler states to the domain-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting samplers to (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers in the array. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + + Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + Passes a value from a source linking node to a destination linking node. - Microsoft Docs: - A pointer to the ID3D11LinkingNode interface for the source linking node. + + Microsoft Docs: + + + A pointer to the ID3D11LinkingNode interface for the source linking node. + The zero-based index of the source parameter. - A pointer to the ID3D11LinkingNode interface for the destination linking node. + + A pointer to the ID3D11LinkingNode interface for the destination linking node. + The zero-based index of the destination parameter. Identifies the texture resource for a video decoder output view. - Microsoft Docs: + + Microsoft Docs: + @@ -7186,23 +9920,33 @@ matrix Gets the corresponding interface slot for a variable that represents an interface pointer. - Microsoft Docs: + + Microsoft Docs: + Index of the array element to get the slot number for. For a non-array variable this value will be zero. Sets the amount of downsampling to perform on the output. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - If TRUE, downsampling is enabled. Otherwise, downsampling is disabled and the Size member is ignored. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + If TRUE, downsampling is enabled. Otherwise, downsampling is disabled and the Size member is ignored. + The sampling size. Specifies how to handle the existing contents of a resource during a copy or update operation of a region within that resource. - Microsoft Docs: + + Microsoft Docs: + @@ -7214,56 +9958,84 @@ matrix Turns multithread protection on or off. - Microsoft Docs: + + Microsoft Docs: + Set to true to turn multithread protection on, false to turn it off. Get the constant buffers used by the domain-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + + Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + Provides the video functionality of a Microsoft Direct3D 11 device. - Microsoft Docs: + + Microsoft Docs: + Create a depth-stencil state object that encapsulates depth-stencil test information for the output-merger stage. - Microsoft Docs: - Pointer to a depth-stencil state description (see D3D11_DEPTH_STENCIL_DESC). - Address of a pointer to the depth-stencil state object created (see ID3D11DepthStencilState). + + Microsoft Docs: + + + Pointer to a depth-stencil state description (see D3D11_DEPTH_STENCIL_DESC). + + + Address of a pointer to the depth-stencil state object created (see ID3D11DepthStencilState). + Gets the type of device context. - Microsoft Docs: + + Microsoft Docs: + Creates a video decoder device for Microsoft Direct3D 11. - Microsoft Docs: - A pointer to a D3D11_VIDEO_DECODER_DESC structure that describes the video stream and the decoder profile. - A pointer to a D3D11_VIDEO_DECODER_CONFIG structure that specifies the decoder configuration. - Receives a pointer to the ID3D11VideoDecoder interface. The caller must release the interface. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_DECODER_DESC structure that describes the video stream and the decoder profile. + + + A pointer to a D3D11_VIDEO_DECODER_CONFIG structure that specifies the decoder configuration. + + + Receives a pointer to the ID3D11VideoDecoder interface. The caller must release the interface. + Describes a shader signature. - Microsoft Docs: + + Microsoft Docs: + - A per-parameter string that identifies how the data will be used. For more info, see Semantics. + + A per-parameter string that identifies how the data will be used. For more info, see Semantics. + Semantic index that modifies the semantic. Used to differentiate different parameters that use the same semantic. @@ -7272,10 +10044,14 @@ matrix The register that will contain this variable's data. - A D3D_NAME-typed value that identifies a predefined string that determines the functionality of certain pipeline stages. + + A D3D_NAME-typed value that identifies a predefined string that determines the functionality of certain pipeline stages. + - A D3D_REGISTER_COMPONENT_TYPE-typed value that identifies the per-component-data type that is stored in a register. Each register can store up to four-components of data. + + A D3D_REGISTER_COMPONENT_TYPE-typed value that identifies the per-component-data type that is stored in a register. Each register can store up to four-components of data. + Mask which indicates which components of a register are used. @@ -7287,39 +10063,57 @@ matrix Indicates which stream the geometry shader is using for the signature parameter. - A D3D_MIN_PRECISION-typed value that indicates the minimum desired interpolation precision. For more info, see Using HLSL minimum precision. + + A D3D_MIN_PRECISION-typed value that indicates the minimum desired interpolation precision. For more info, see Using HLSL minimum precision. + Pop a retrieval filter from the top of the retrieval-filter stack. - Microsoft Docs: + + Microsoft Docs: + This interface encapsulates methods for retrieving data from the GPU asynchronously. - Microsoft Docs: + + Microsoft Docs: + Mark the end of a series of commands. - Microsoft Docs: - A pointer to an ID3D11Asynchronous interface. + + Microsoft Docs: + + + A pointer to an ID3D11Asynchronous interface. + Releases a buffer that was obtained by calling the ID3D11VideoContext::GetDecoderBuffer method. - Microsoft Docs: - A pointer to the ID3D11VideoDecoder interface. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoder. - The type of buffer to release. Specify the same value that was used in the Type parameter of the GetDecoderBuffer method. + + Microsoft Docs: + + + A pointer to the ID3D11VideoDecoder interface. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoder. + + + The type of buffer to release. Specify the same value that was used in the Type parameter of the GetDecoderBuffer method. + Specifies the subresource from a 2D texture to use in a render-target view. - Microsoft Docs: + + Microsoft Docs: + @@ -7328,49 +10122,73 @@ matrix Returns a group of video processor capabilities that are associated with frame-rate conversion, including deinterlacing and inverse telecine. - Microsoft Docs: - The zero-based index of the group to retrieve. To get the maximum index, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the RateConversionCapsCount member of the D3D11_VIDEO_PROCESSOR_CAPS structure. - A pointer to a D3D11_VIDEO_PROCESSOR_RATE_CONVERSION_CAPS structure that receives the frame-rate conversion capabilities. + + Microsoft Docs: + + + The zero-based index of the group to retrieve. To get the maximum index, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the RateConversionCapsCount member of the D3D11_VIDEO_PROCESSOR_CAPS structure. + + + A pointer to a D3D11_VIDEO_PROCESSOR_RATE_CONVERSION_CAPS structure that receives the frame-rate conversion capabilities. + Gets the base class of a class. - Microsoft Docs: + + Microsoft Docs: + Provides the video functionality of a Microsoft Direct3D 11 device. - Microsoft Docs: + + Microsoft Docs: + Provides the video decoding and video processing capabilities of a Microsoft Direct3D 11 device. - Microsoft Docs: + + Microsoft Docs: + Switches to a new session key. - Microsoft Docs: - A pointer to the ID3D11CryptoSession interface. + + Microsoft Docs: + + + A pointer to the ID3D11CryptoSession interface. + Set a hull shader to the device. - Microsoft Docs: - Pointer to a hull shader (see ID3D11HullShader). Passing in NULL disables the shader for this pipeline stage. - A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + + Microsoft Docs: + + + Pointer to a hull shader (see ID3D11HullShader). Passing in NULL disables the shader for this pipeline stage. + + + A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + The number of class-instance interfaces in the array. Defines a group of video processor capabilities that are associated with frame-rate conversion, including deinterlacing and inverse telecine. - Microsoft Docs: + + Microsoft Docs: + @@ -7380,37 +10198,57 @@ matrix The number of future reference frames required to perform the optimal video processing. - A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_PROCESSOR_CAPS enumeration. + + A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_PROCESSOR_CAPS enumeration. + - A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_ITELECINE_CAPS enumeration. + + A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_ITELECINE_CAPS enumeration. + - The number of custom frame rates that the driver supports. To get the list of custom frame rates, call the ID3D11VideoProcessorEnumerator::GetVideoProcessorCustomRate method. + + The number of custom frame rates that the driver supports. To get the list of custom frame rates, call the ID3D11VideoProcessorEnumerator::GetVideoProcessorCustomRate method. + Creates a deferred context, which can record command lists. - Microsoft Docs: - Reserved for future use. - Pass 0. - Upon completion of the method, the passed pointer to an ID3D11DeviceContext2 interface pointer is initialized. + + Microsoft Docs: + + + Reserved for future use. + Pass 0. + + + Upon completion of the method, the passed pointer to an ID3D11DeviceContext2 interface pointer is initialized. + Set an array of sampler states to the vertex shader pipeline stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting samplers to (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers in the array. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + + Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + Specifies whether the video processor input stream should be flipped vertically or horizontally. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + An index identifying the input stream. True if mirroring should be enabled; otherwise, false. True if the stream should be flipped horizontally; otherwise, false. @@ -7420,7 +10258,9 @@ matrix Describes feature data GPU virtual address support, including maximum address bits per resource and per process. - Microsoft Docs: + + Microsoft Docs: + @@ -7432,15 +10272,23 @@ matrix The device interface represents a virtual adapter; it is used to create resources. ID3D11Device3 adds new methods to those in ID3D11Device2. - Microsoft Docs: + + Microsoft Docs: + Sets the stream rotation for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + Specifies if the stream is to be rotated in a clockwise orientation. Specifies the rotation of the stream. @@ -7448,41 +10296,59 @@ matrix Specifies the subresources from a 3D texture to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + - Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original Texture3D for which ID3D11Device::CreateShaderResourceView creates a view) -1. + + Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original Texture3D for which ID3D11Device::CreateShaderResourceView creates a view) -1. + - The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. + + The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. -Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + Defines a color value for Microsoft Direct3D 11 video. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_VIDEO_COLOR_YCbCrA structure that contains a YCbCr color value. + + A D3D11_VIDEO_COLOR_YCbCrA structure that contains a YCbCr color value. + - A D3D11_VIDEO_COLOR_RGBA structure that contains an RGB color value. + + A D3D11_VIDEO_COLOR_RGBA structure that contains an RGB color value. + Get a description of how a resource is bound to a shader. - Microsoft Docs: + + Microsoft Docs: + A zero-based resource index. - A pointer to an input-binding description. See D3D11_SHADER_INPUT_BIND_DESC. + + A pointer to an input-binding description. See D3D11_SHADER_INPUT_BIND_DESC. + Specifies how to access a resource that is used in a video processor input view. - Microsoft Docs: + + Microsoft Docs: + @@ -7494,7 +10360,9 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Describes the level of support for shared resources in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + @@ -7503,20 +10371,26 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Get an interface by index. - Microsoft Docs: + + Microsoft Docs: + Zero-based index. A render-target-view interface represents the render-target subresources that can be accessed during rendering. - Microsoft Docs: + + Microsoft Docs: + Contains an initialization vector (IV) for 128-bit Advanced Encryption Standard CTR mode (AES-CTR) block cipher encryption. - Microsoft Docs: + + Microsoft Docs: + @@ -7528,24 +10402,40 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Sets the output signature of the function-linking-graph. - Microsoft Docs: - An array of D3D11_PARAMETER_DESC structures for the parameters of the output signature. - The number of output parameters in the pOutputParameters array. - A pointer to a variable that receives a pointer to the ID3D11LinkingNode interface that represents the output signature of the function-linking-graph. + + Microsoft Docs: + + + An array of D3D11_PARAMETER_DESC structures for the parameters of the output signature. + + + The number of output parameters in the pOutputParameters array. + + + A pointer to a variable that receives a pointer to the ID3D11LinkingNode interface that represents the output signature of the function-linking-graph. + Get the size of the data (in bytes) that is output when calling ID3D11DeviceContext::GetData. - Microsoft Docs: + + Microsoft Docs: + Gets the stream rotation for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + Specifies if the stream is rotated. Specifies the rotation of the stream in a clockwise orientation. @@ -7553,14 +10443,20 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Indicates whether two ID3D11ShaderReflectionType Interface pointers have the same underlying type. - Microsoft Docs: - A pointer to a ID3D11ShaderReflectionType Interface. + + Microsoft Docs: + + + A pointer to a ID3D11ShaderReflectionType Interface. + Describes an instance of a vertex shader to trace. - Microsoft Docs: + + Microsoft Docs: + @@ -7569,7 +10465,9 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Specifies the elements in a buffer resource to use in a render-target view. - Microsoft Docs: + + Microsoft Docs: + @@ -7587,13 +10485,17 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down A function-parameter-reflection interface accesses function-parameter info. - Microsoft Docs: + + Microsoft Docs: + The different faces of a cube texture. - Microsoft Docs: + + Microsoft Docs: + @@ -7617,76 +10519,118 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Links the shader and produces a shader blob that the Direct3D runtime can use. - Microsoft Docs: - A pointer to the ID3D11ModuleInstance interface for the shader module instance to link from. + + Microsoft Docs: + + + A pointer to the ID3D11ModuleInstance interface for the shader module instance to link from. + The name of the shader module instance to link from. The name for the shader blob that is produced. Reserved. - A pointer to a variable that receives a pointer to the ID3DBlob interface that you can use to access the compiled shader code. - A pointer to a variable that receives a pointer to the ID3DBlob interface that you can use to access compiler error messages. + + A pointer to a variable that receives a pointer to the ID3DBlob interface that you can use to access the compiled shader code. + + + A pointer to a variable that receives a pointer to the ID3DBlob interface that you can use to access compiler error messages. + Describes a 3D texture. - Microsoft Docs: + + Microsoft Docs: + - Texture width (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Texture width (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - Texture height (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Texture height (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - Texture depth (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Texture depth (in texels). The range is from 1 to D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - The maximum number of mipmap levels in the texture. See the remarks in D3D11_TEX1D_SRV. Use 1 for a multisampled texture; or 0 to generate a full set of subtextures. + + The maximum number of mipmap levels in the texture. See the remarks in D3D11_TEX1D_SRV. Use 1 for a multisampled texture; or 0 to generate a full set of subtextures. + - Texture format (see DXGI_FORMAT). + + Texture format (see DXGI_FORMAT). + - Value that identifies how the texture is to be read from and written to. The most common value is D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + + Value that identifies how the texture is to be read from and written to. The most common value is D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + - Flags (see D3D11_BIND_FLAG) for binding to pipeline stages. The flags can be combined by a logical OR. + + Flags (see D3D11_BIND_FLAG) for binding to pipeline stages. The flags can be combined by a logical OR. + - Flags (see D3D11_CPU_ACCESS_FLAG) to specify the types of CPU access allowed. Use 0 if CPU access is not required. These flags can be combined with a logical OR. + + Flags (see D3D11_CPU_ACCESS_FLAG) to specify the types of CPU access allowed. Use 0 if CPU access is not required. These flags can be combined with a logical OR. + - Flags (see D3D11_RESOURCE_MISC_FLAG) that identify other, less common resource options. Use 0 if none of these flags apply. These flags can be combined with a logical OR. + + Flags (see D3D11_RESOURCE_MISC_FLAG) that identify other, less common resource options. Use 0 if none of these flags apply. These flags can be combined with a logical OR. + - A D3D11_TEXTURE_LAYOUT-typed value that identifies the layout of the texture. + + A D3D11_TEXTURE_LAYOUT-typed value that identifies the layout of the texture. -The TextureLayout parameter selects both the actual layout of the texture in memory and the layout visible to the application while the texture is mapped. These flags may not be requested without CPU access also requested. + The TextureLayout parameter selects both the actual layout of the texture in memory and the layout visible to the application while the texture is mapped. These flags may not be requested without CPU access also requested. -It is illegal to set CPU access flags on default textures without also setting Layout to a value other than D3D11_TEXTURE_LAYOUT_UNDEFINED. + It is illegal to set CPU access flags on default textures without also setting Layout to a value other than D3D11_TEXTURE_LAYOUT_UNDEFINED. -D3D11_TEXTURE_LAYOUT_ROW_MAJOR may not be used with 3D textures. D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE may not be used with 3D textures that have mipmaps. + D3D11_TEXTURE_LAYOUT_ROW_MAJOR may not be used with 3D textures. D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE may not be used with 3D textures that have mipmaps. + Creates a blend-state object that encapsulates blend state for the output-merger stage and allows the configuration of logic operations. - Microsoft Docs: - A pointer to a D3D11_BLEND_DESC1 structure that describes blend state. - Address of a pointer to the ID3D11BlendState1 interface for the blend-state object created. + + Microsoft Docs: + + + A pointer to a D3D11_BLEND_DESC1 structure that describes blend state. + + + Address of a pointer to the ID3D11BlendState1 interface for the blend-state object created. + Get a message identifier to break on when a message with that identifier passes through the storage filter. - Microsoft Docs: - Message identifier to break on (see D3D11_MESSAGE_ID). + + Microsoft Docs: + + + Message identifier to break on (see D3D11_MESSAGE_ID). + Identifies the type of resource being used. - Microsoft Docs: + + Microsoft Docs: + @@ -7707,7 +10651,9 @@ D3D11_TEXTURE_LAYOUT_ROW_MAJOR may not be used with 3D textures. D3D11_TEXTURE_ Type of data contained in an input slot. - Microsoft Docs: + + Microsoft Docs: + @@ -7719,89 +10665,134 @@ D3D11_TEXTURE_LAYOUT_ROW_MAJOR may not be used with 3D textures. D3D11_TEXTURE_ Gets the function reflector. - Microsoft Docs: + + Microsoft Docs: + The zero-based index of the function reflector to retrieve. Describes precision support options for shaders in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + - A combination of D3D11_SHADER_MIN_PRECISION_SUPPORT-typed values that are combined by using a bitwise OR operation. The resulting value specifies minimum precision levels that the driver supports for the pixel shader. A value of zero indicates that the driver supports only full 32-bit precision for the pixel shader. + + A combination of D3D11_SHADER_MIN_PRECISION_SUPPORT-typed values that are combined by using a bitwise OR operation. The resulting value specifies minimum precision levels that the driver supports for the pixel shader. A value of zero indicates that the driver supports only full 32-bit precision for the pixel shader. + - A combination of D3D11_SHADER_MIN_PRECISION_SUPPORT-typed values that are combined by using a bitwise OR operation. The resulting value specifies minimum precision levels that the driver supports for all other shader stages. A value of zero indicates that the driver supports only full 32-bit precision for all other shader stages. + + A combination of D3D11_SHADER_MIN_PRECISION_SUPPORT-typed values that are combined by using a bitwise OR operation. The resulting value specifies minimum precision levels that the driver supports for all other shader stages. A value of zero indicates that the driver supports only full 32-bit precision for all other shader stages. + Represents a query object for querying information from the graphics processing unit (GPU). - Microsoft Docs: + + Microsoft Docs: + Set the blend state of the output-merger stage. - Microsoft Docs: - Pointer to a blend-state interface (see ID3D11BlendState). Pass NULL for a default blend state. For more info about default blend state, see Remarks. - Array of blend factors, one for each RGBA component. The blend factors modulate values for the pixel shader, render target, or both. If you created the blend-state object with D3D11_BLEND_BLEND_FACTOR or D3D11_BLEND_INV_BLEND_FACTOR, the blending stage uses the non-NULL array of blend factors. If you didn't create the blend-state object with D3D11_BLEND_BLEND_FACTOR or D3D11_BLEND_INV_BLEND_FACTOR, the blending stage does not use the non-NULL array of blend factors; the runtime stores the blend factors, and you can later call ID3D11DeviceContext::OMGetBlendState to retrieve the blend factors. If you pass NULL, the runtime uses or stores a blend factor equal to { 1, 1, 1, 1 }. + + Microsoft Docs: + + + Pointer to a blend-state interface (see ID3D11BlendState). Pass NULL for a default blend state. For more info about default blend state, see Remarks. + + + Array of blend factors, one for each RGBA component. The blend factors modulate values for the pixel shader, render target, or both. If you created the blend-state object with D3D11_BLEND_BLEND_FACTOR or D3D11_BLEND_INV_BLEND_FACTOR, the blending stage uses the non-NULL array of blend factors. If you didn't create the blend-state object with D3D11_BLEND_BLEND_FACTOR or D3D11_BLEND_INV_BLEND_FACTOR, the blending stage does not use the non-NULL array of blend factors; the runtime stores the blend factors, and you can later call ID3D11DeviceContext::OMGetBlendState to retrieve the blend factors. If you pass NULL, the runtime uses or stores a blend factor equal to { 1, 1, 1, 1 }. + 32-bit sample coverage. The default value is 0xffffffff. See remarks. Get the description of a shader-reflection-variable type. - Microsoft Docs: - A pointer to a shader-type description (see D3D11_SHADER_TYPE_DESC). + + Microsoft Docs: + + + A pointer to a shader-type description (see D3D11_SHADER_TYPE_DESC). + Create a command list and record graphics commands into it. - Microsoft Docs: - A Boolean flag that determines whether the runtime saves deferred context state before it executes FinishCommandList and restores it afterwards. Use TRUE to indicate that the runtime needs to save and restore the state. Use FALSE to indicate that the runtime will not save or restore any state. In this case, the deferred context will return to its default state after the call to FinishCommandList completes. For information about default state, see ID3D11DeviceContext::ClearState. Typically, use FALSE unless you restore the state to be nearly equivalent to the state that the runtime would restore if you passed TRUE. When you use FALSE, you can avoid unnecessary and inefficient state transitions. - + + Microsoft Docs: + + + A Boolean flag that determines whether the runtime saves deferred context state before it executes FinishCommandList and restores it afterwards. Use TRUE to indicate that the runtime needs to save and restore the state. Use FALSE to indicate that the runtime will not save or restore any state. In this case, the deferred context will return to its default state after the call to FinishCommandList completes. For information about default state, see ID3D11DeviceContext::ClearState. Typically, use FALSE unless you restore the state to be nearly equivalent to the state that the runtime would restore if you passed TRUE. When you use FALSE, you can avoid unnecessary and inefficient state transitions. -
Note  This parameter does not affect the command list that the current call to FinishCommandList returns. However, this parameter affects the command list of the next call to FinishCommandList on the same deferred context. -
-
 
- Upon completion of the method, the passed pointer to an ID3D11CommandList interface pointer is initialized with the recorded command list information. The resulting ID3D11CommandList object is immutable and can only be used with ID3D11DeviceContext::ExecuteCommandList. + +
+ Note  This parameter does not affect the command list that the current call to FinishCommandList returns. However, this parameter affects the command list of the next call to FinishCommandList on the same deferred context. +
+
 
+ + + Upon completion of the method, the passed pointer to an ID3D11CommandList interface pointer is initialized with the recorded command list information. The resulting ID3D11CommandList object is immutable and can only be used with ID3D11DeviceContext::ExecuteCommandList. + Get the number of messages that are able to pass through a retrieval filter. - Microsoft Docs: + + Microsoft Docs: + Gets the capabilities of the video processor. - Microsoft Docs: - A pointer to a D3D11_VIDEO_PROCESSOR_CAPS structure that receives the capabilities. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_PROCESSOR_CAPS structure that receives the capabilities. + Push an empty retrieval filter onto the retrieval-filter stack. - Microsoft Docs: + + Microsoft Docs: + Gets the current target rectangle for the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - Receives the value TRUE if the target rectangle was explicitly set using the ID3D11VideoContext::VideoProcessorSetOutputTargetRect method. Receives the value FALSE if the target rectangle was disabled or was never set. - If Enabled receives the value TRUE, this parameter receives the target rectangle. Otherwise, this parameter is ignored. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + Receives the value TRUE if the target rectangle was explicitly set using the ID3D11VideoContext::VideoProcessorSetOutputTargetRect method. Receives the value FALSE if the target rectangle was disabled or was never set. + + + If Enabled receives the value TRUE, this parameter receives the target rectangle. Otherwise, this parameter is ignored. + Describes a unordered-access 2D texture resource. - Microsoft Docs: + + Microsoft Docs: + @@ -7813,54 +10804,74 @@ D3D11_TEXTURE_LAYOUT_ROW_MAJOR may not be used with 3D textures. D3D11_TEXTURE_ Describes a query. - Microsoft Docs: + + Microsoft Docs: + - Type of query (see D3D11_QUERY). + + Type of query (see D3D11_QUERY). + - Miscellaneous flags (see D3D11_QUERY_MISC_FLAG). + + Miscellaneous flags (see D3D11_QUERY_MISC_FLAG). + Contains input data for a D3D11_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE command. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_CONFIGURE_INPUT structure that contains the command GUID and other data. + + A D3D11_AUTHENTICATED_CONFIGURE_INPUT structure that contains the command GUID and other data. + - A D3D11_AUTHENTICATED_PROCESS_IDENTIFIER_TYPE value that specifies the type of process. + + A D3D11_AUTHENTICATED_PROCESS_IDENTIFIER_TYPE value that specifies the type of process. -To specify the Desktop Window Manager (DWM) process, set this member to D3D11_PROCESSIDTYPE_DWM. Otherwise, set this member to D3D11_PROCESSIDTYPE_HANDLE and set the ProcessHandle member to a valid handle. + To specify the Desktop Window Manager (DWM) process, set this member to D3D11_PROCESSIDTYPE_DWM. Otherwise, set this member to D3D11_PROCESSIDTYPE_HANDLE and set the ProcessHandle member to a valid handle. + - A process handle. If the ProcessType member equals D3D11_PROCESSIDTYPE_HANDLE, the ProcessHandle member specifies a handle to a process. Otherwise, the value is ignored. + + A process handle. If the ProcessType member equals D3D11_PROCESSIDTYPE_HANDLE, the ProcessHandle member specifies a handle to a process. Otherwise, the value is ignored. + - If TRUE, the specified process has access to restricted shared resources. + + If TRUE, the specified process has access to restricted shared resources. + Describes the size of a tiled region. - Microsoft Docs: + + Microsoft Docs: + The number of tiles in the tiled region. - Specifies whether the runtime uses the Width, Height, and Depth members to define the region. + + Specifies whether the runtime uses the Width, Height, and Depth members to define the region. -If TRUE, the runtime uses the Width, Height, and Depth members to define the region. + If TRUE, the runtime uses the Width, Height, and Depth members to define the region. -If FALSE, the runtime ignores the Width, Height, and Depth members and uses the NumTiles member to traverse tiles in the resource linearly across x, then y, then z (as applicable) and then spills over mipmaps/arrays in subresource order. For example, use this technique to map an entire resource at once. + If FALSE, the runtime ignores the Width, Height, and Depth members and uses the NumTiles member to traverse tiles in the resource linearly across x, then y, then z (as applicable) and then spills over mipmaps/arrays in subresource order. For example, use this technique to map an entire resource at once. -Regardless of whether you specify TRUE or FALSE for bUseBox, you use a D3D11_TILED_RESOURCE_COORDINATE structure to specify the starting location for the region within the resource as a separate parameter outside of this structure by using x, y, and z coordinates. + Regardless of whether you specify TRUE or FALSE for bUseBox, you use a D3D11_TILED_RESOURCE_COORDINATE structure to specify the starting location for the region within the resource as a separate parameter outside of this structure by using x, y, and z coordinates. -When the region includes mipmaps that are packed with nonstandard tiling, bUseBox must be FALSE because tile dimensions are not standard and the app only knows a count of how many tiles are consumed by the packed area, which is per array slice. The corresponding (separate) starting location parameter uses x to offset into the flat range of tiles in this case, and y and z coordinates must each be 0. + When the region includes mipmaps that are packed with nonstandard tiling, bUseBox must be FALSE because tile dimensions are not standard and the app only knows a count of how many tiles are consumed by the packed area, which is per array slice. The corresponding (separate) starting location parameter uses x to offset into the flat range of tiles in this case, and y and z coordinates must each be 0. + The width of the tiled region, in tiles. Used for buffer and 1D, 2D, and 3D textures. @@ -7874,7 +10885,9 @@ When the region includes mipmaps that are packed with nonstandard tiling, bUs Draw non-indexed, instanced primitives. - Microsoft Docs: + + Microsoft Docs: + Number of vertices to draw. Number of instances to draw. Index of the first vertex. @@ -7884,29 +10897,43 @@ When the region includes mipmaps that are packed with nonstandard tiling, bUs Creates a 3D texture. - Microsoft Docs: - A pointer to a D3D11_TEXTURE3D_DESC1 structure that describes a 3D texture resource. To create a typeless resource that can be interpreted at runtime into different, compatible formats, specify a typeless format in the texture description. To generate mipmap levels automatically, set the number of mipmap levels to 0. - A pointer to an array of D3D11_SUBRESOURCE_DATA structures that describe subresources for the 3D texture resource. Applications can't specify NULL for pInitialData when creating IMMUTABLE resources (see D3D11_USAGE). If the resource is multisampled, pInitialData must be NULL because multisampled resources can't be initialized with data when they are created. + + Microsoft Docs: + + + A pointer to a D3D11_TEXTURE3D_DESC1 structure that describes a 3D texture resource. To create a typeless resource that can be interpreted at runtime into different, compatible formats, specify a typeless format in the texture description. To generate mipmap levels automatically, set the number of mipmap levels to 0. + + + A pointer to an array of D3D11_SUBRESOURCE_DATA structures that describe subresources for the 3D texture resource. Applications can't specify NULL for pInitialData when creating IMMUTABLE resources (see D3D11_USAGE). If the resource is multisampled, pInitialData must be NULL because multisampled resources can't be initialized with data when they are created. -If you don't pass anything to pInitialData, the initial content of the memory for the resource is undefined. In this case, you need to write the resource content some other way before the resource is read. + If you don't pass anything to pInitialData, the initial content of the memory for the resource is undefined. In this case, you need to write the resource content some other way before the resource is read. -You can determine the size of this array from the value in the MipLevels member of the D3D11_TEXTURE3D_DESC1 structure to which pDesc1 points. Arrays of 3D volume textures aren't supported. + You can determine the size of this array from the value in the MipLevels member of the D3D11_TEXTURE3D_DESC1 structure to which pDesc1 points. Arrays of 3D volume textures aren't supported. -For more information about this array size, see Remarks. - A pointer to a memory block that receives a pointer to a ID3D11Texture3D1 interface for the created texture. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + For more information about this array size, see Remarks. + + + A pointer to a memory block that receives a pointer to a ID3D11Texture3D1 interface for the created texture. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Creates class linkage libraries to enable dynamic shader linkage. - Microsoft Docs: - A pointer to a class-linkage interface pointer (see ID3D11ClassLinkage). + + Microsoft Docs: + + + A pointer to a class-linkage interface pointer (see ID3D11ClassLinkage). + Describes an array of unordered-access 2D texture resources. - Microsoft Docs: + + Microsoft Docs: + @@ -7921,26 +10948,38 @@ For more information about this array size, see Remarks. A linker interface is used to link a shader module. - Microsoft Docs: + + Microsoft Docs: + Get the support of a given format on the installed video device. - Microsoft Docs: - A DXGI_FORMAT enumeration that describes a format for which to check for support. - A bitfield of D3D11_FORMAT_SUPPORT enumeration values describing how the specified format is supported on the installed device. - The values are ORed together. + + Microsoft Docs: + + + A DXGI_FORMAT enumeration that describes a format for which to check for support. + + + A bitfield of D3D11_FORMAT_SUPPORT enumeration values describing how the specified format is supported on the installed device. + The values are ORed together. + Contains the response to a D3D11_AUTHENTICATED_QUERY_OUTPUT_ID_COUNT query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + A handle to the device. @@ -7954,77 +10993,114 @@ For more information about this array size, see Remarks. Gets the current output color space for the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - A pointer to a D3D11_VIDEO_PROCESSOR_COLOR_SPACE structure. The method fills in the structure with the output color space. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + A pointer to a D3D11_VIDEO_PROCESSOR_COLOR_SPACE structure. The method fills in the structure with the output color space. + Gets the HDR metadata associated with the video stream. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + Identifies the input stream. The type of the HDR metadata currently associated with the stream. - The size of the memory referenced by pHDRMetaData. + + The size of the memory referenced by pHDRMetaData. -If pHDRMetaData is NULL, Size should be 0. - Pointer to a buffer that receives the HDR metadata. + If pHDRMetaData is NULL, Size should be 0. + + + Pointer to a buffer that receives the HDR metadata. -This parameter can be NULL. + This parameter can be NULL. + Push a retrieval filter onto the retrieval-filter stack. - Microsoft Docs: - Pointer to a retrieval filter (see D3D11_INFO_QUEUE_FILTER). + + Microsoft Docs: + + + Pointer to a retrieval filter (see D3D11_INFO_QUEUE_FILTER). + Sets graphics processing unit (GPU) debug reference tracking options. - Microsoft Docs: - A combination of D3D11_SHADER_TRACKING_OPTIONS-typed flags that are combined by using a bitwise OR operation. The resulting value identifies tracking options. If a flag is present, the tracking option that the flag represents is set to "on"; otherwise the tracking option is set to "off." + + Microsoft Docs: + + + A combination of D3D11_SHADER_TRACKING_OPTIONS-typed flags that are combined by using a bitwise OR operation. The resulting value identifies tracking options. If a flag is present, the tracking option that the flag represents is set to "on"; otherwise the tracking option is set to "off." + Updates the decoder downsampling parameters. - Microsoft Docs: - A pointer to the ID3D11VideoDecoder interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoDecoder interface. + The resolution, format, and colorspace of the output/display frames. This is the destination resolution and format of the downsample operation. Gets the type of encryption that is supported by this session. - Microsoft Docs: - Receives a GUID that specifies the encryption type. The following GUIDs are defined. + + Microsoft Docs: + + + Receives a GUID that specifies the encryption type. The following GUIDs are defined. - - - - - - - - + +
ValueMeaning
-
D3D11_CRYPTO_TYPE_AES128_CTR
-
-		 -128-bit Advanced Encryption Standard CTR mode (AES-CTR) block cipher. + + + + + + + + - -
ValueMeaning
+ + +
+
+ D3D11_CRYPTO_TYPE_AES128_CTR +
+
+ 		+ 128-bit Advanced Encryption Standard CTR mode (AES-CTR) block cipher. -
+
+ Identifies how to check multisample quality levels. - Microsoft Docs: + + Microsoft Docs: + @@ -8033,7 +11109,9 @@ This parameter can be NULL. Describes a unordered-access 1D texture resource. - Microsoft Docs: + + Microsoft Docs: + @@ -8042,10 +11120,18 @@ This parameter can be NULL. Gets the luma key for an input stream of the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Receives the value TRUE if luma keying is enabled, or FALSE otherwise. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Receives the value TRUE if luma keying is enabled, or FALSE otherwise. + Receives the lower bound for the luma key. The valid range is [0…1]. Receives the upper bound for the luma key. The valid range is [0…1]. @@ -8053,14 +11139,18 @@ This parameter can be NULL. Describes how a shader resource is bound to a shader input. - Microsoft Docs: + + Microsoft Docs: + Name of the shader resource. - A D3D_SHADER_INPUT_TYPE-typed value that identifies the type of data in the resource. + + A D3D_SHADER_INPUT_TYPE-typed value that identifies the type of data in the resource. + Starting bind point. @@ -8069,13 +11159,19 @@ This parameter can be NULL. Number of contiguous bind points for arrays. - A combination of D3D_SHADER_INPUT_FLAGS-typed values for shader input-parameter options. + + A combination of D3D_SHADER_INPUT_FLAGS-typed values for shader input-parameter options. + - If the input is a texture, the D3D_RESOURCE_RETURN_TYPE-typed value that identifies the return type. + + If the input is a texture, the D3D_RESOURCE_RETURN_TYPE-typed value that identifies the return type. + - A D3D_SRV_DIMENSION-typed value that identifies the dimensions of the bound resource. + + A D3D_SRV_DIMENSION-typed value that identifies the dimensions of the bound resource. + The number of samples for a multisampled texture; when a texture isn't multisampled, the value is set to -1 (0xFFFFFFFF). @@ -8083,7 +11179,9 @@ This parameter can be NULL. Specifies a multi-sample pattern type. - Microsoft Docs: + + Microsoft Docs: + @@ -8095,66 +11193,92 @@ This parameter can be NULL. The sampler-state interface holds a description for sampler state that you can bind to any shader stage of the pipeline for reference by texture sample operations. - Microsoft Docs: + + Microsoft Docs: + Get a shader-variable type. - Microsoft Docs: + + Microsoft Docs: + Creates a cryptographic session to encrypt video content that is sent to the graphics driver. - Microsoft Docs: - A pointer to a GUID that specifies the type of encryption to use. The following GUIDs are defined. + + Microsoft Docs: + + + A pointer to a GUID that specifies the type of encryption to use. The following GUIDs are defined. - - - - - - - - + +
ValueMeaning
-
D3D11_CRYPTO_TYPE_AES128_CTR
-
-		 -128-bit Advanced Encryption Standard CTR mode (AES-CTR) block cipher. + + + + + + + + - -
ValueMeaning
+ + +
+
+ D3D11_CRYPTO_TYPE_AES128_CTR +
+
+ 		+ 128-bit Advanced Encryption Standard CTR mode (AES-CTR) block cipher. -
- A pointer to a GUID that specifies the decoding profile. For a list of possible values, see ID3D11VideoDevice::GetVideoDecoderProfile. If decoding will not be used, set this parameter to NULL. - A pointer to a GUID that specifies the type of key exchange. +
+ + + A pointer to a GUID that specifies the decoding profile. For a list of possible values, see ID3D11VideoDevice::GetVideoDecoderProfile. If decoding will not be used, set this parameter to NULL. + + + A pointer to a GUID that specifies the type of key exchange. - - - - - - - - + +
ValueMeaning
-
D3D11_KEY_EXCHANGE_RSAES_OAEP
-
-		 -The caller will create the session key, encrypt it with RSA Encryption Scheme - Optimal Asymmetric Encryption Padding (RSAES-OAEP) by using the driver's public key, and pass the session key to the driver. + + + + + + + + - -
ValueMeaning
+ + +
+
+ D3D11_KEY_EXCHANGE_RSAES_OAEP +
+
+ 		+ The caller will create the session key, encrypt it with RSA Encryption Scheme - Optimal Asymmetric Encryption Padding (RSAES-OAEP) by using the driver's public key, and pass the session key to the driver. -
- Receives a pointer to the ID3D11CryptoSession interface. The caller must release the interface. +
+ + + Receives a pointer to the ID3D11CryptoSession interface. The caller must release the interface. + Identifies a video processor filter. - Microsoft Docs: + + Microsoft Docs: + @@ -8179,39 +11303,55 @@ The caller will create the session key, encrypt it with RSA Encryption Scheme - Anamorphic scaling filter. - Stereo adjustment filter. When stereo 3D video is enabled, this filter adjusts the offset between the left and right views, allowing the user to reduce potential eye strain. + + Stereo adjustment filter. When stereo 3D video is enabled, this filter adjusts the offset between the left and right views, allowing the user to reduce potential eye strain. -The filter value indicates the amount by which the left and right views are adjusted. A positive value shifts the images away from each other: the left image toward the left, and the right image toward the right. A negative value shifts the images in the opposite directions, closer to each other. + The filter value indicates the amount by which the left and right views are adjusted. A positive value shifts the images away from each other: the left image toward the left, and the right image toward the right. A negative value shifts the images in the opposite directions, closer to each other. + Get a pointer to the device that created this interface. - Microsoft Docs: - Address of a pointer to a device (see ID3D11Device). + + Microsoft Docs: + + + Address of a pointer to a device (see ID3D11Device). + Sets the constant buffers that the pixel shader pipeline stage uses, and enables the shader to access other parts of the buffer. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + Array of constant buffers being given to the device. - An array that holds the offsets into the buffers that ppConstantBuffers specifies. - Each offset specifies where, from the shader's point of view, each constant buffer starts. - Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). - Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. - Each offset must be a multiple of 16 constants. - An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. - Each number specifies the number of constants that are contained in the constant buffer that the shader uses. - Each number of constants starts from its respective offset that is specified in the pFirstConstant array. - Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + + An array that holds the offsets into the buffers that ppConstantBuffers specifies. + Each offset specifies where, from the shader's point of view, each constant buffer starts. + Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). + Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. + Each offset must be a multiple of 16 constants. + + + An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. + Each number specifies the number of constants that are contained in the constant buffer that the shader uses. + Each number of constants starts from its respective offset that is specified in the pFirstConstant array. + Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + Specifies the subresources from an array 2D textures that are accessible to a depth-stencil view. - Microsoft Docs: + + Microsoft Docs: + @@ -8226,7 +11366,9 @@ The filter value indicates the amount by which the left and right views are adju Rebinds a constant buffer from a source slot to a destination slot. - Microsoft Docs: + + Microsoft Docs: + The source slot number for rebinding. The destination slot number for rebinding. The offset in bytes of the destination slot for rebinding. The offset must have 16-byte alignment. @@ -8235,67 +11377,105 @@ The filter value indicates the amount by which the left and right views are adju Sets the reference rasterizer's race-condition tracking options for a specific shader. - Microsoft Docs: - A pointer to the IUnknown interface of a shader. - A combination of D3D11_SHADER_TRACKING_OPTIONS-typed flags that are combined by using a bitwise OR operation. The resulting value identifies tracking options. If a flag is present, the tracking option that the flag represents is set to "on"; otherwise the tracking option is set to "off." + + Microsoft Docs: + + + A pointer to the IUnknown interface of a shader. + + + A combination of D3D11_SHADER_TRACKING_OPTIONS-typed flags that are combined by using a bitwise OR operation. The resulting value identifies tracking options. If a flag is present, the tracking option that the flag represents is set to "on"; otherwise the tracking option is set to "off." + Gets the minimum feature level. - Microsoft Docs: - A pointer to one of the enumerated values in D3D_FEATURE_LEVEL, which represents the minimum feature level. + + Microsoft Docs: + + + A pointer to one of the enumerated values in D3D_FEATURE_LEVEL, which represents the minimum feature level. + Specifies that the shader trace recorded and is ready to use. - Microsoft Docs: - An optional pointer to a variable that receives the number of times that a matching invocation for the trace occurred. If not used, set to NULL. -For more information about this number, see Remarks. + + Microsoft Docs: + + + An optional pointer to a variable that receives the number of times that a matching invocation for the trace occurred. If not used, set to NULL. + For more information about this number, see Remarks. + Queries whether automatic processing features of the video processor are enabled. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Receives the value TRUE if automatic processing features are enabled, or FALSE otherwise. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Receives the value TRUE if automatic processing features are enabled, or FALSE otherwise. + Find out if multithread protection is turned on or not. - Microsoft Docs: + + Microsoft Docs: + Contains input data for a D3D11_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION command. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_CONFIGURE_INPUT structure that contains the command GUID and other data. + + A D3D11_AUTHENTICATED_CONFIGURE_INPUT structure that contains the command GUID and other data. + - A handle to the decoder device. Get this from ID3D11VideoDecoder::GetDriverHandle. + + A handle to the decoder device. Get this from ID3D11VideoDecoder::GetDriverHandle. + - A handle to the cryptographic session. Get this from ID3D11CryptoSession::GetCryptoSessionHandle. + + A handle to the cryptographic session. Get this from ID3D11CryptoSession::GetCryptoSessionHandle. + - A handle to the Direct3D device. Get this from D3D11VideoContext::QueryAuthenticatedChannel using D3D11_AUTHENTICATED_QUERY_DEVICE_HANDLE. + + A handle to the Direct3D device. Get this from D3D11VideoContext::QueryAuthenticatedChannel using D3D11_AUTHENTICATED_QUERY_DEVICE_HANDLE. + Contains input data for a D3D11_AUTHENTICATED_CONFIGURE_INITIALIZE command. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_CONFIGURE_INPUT structure that contains the command GUID and other data. + + A D3D11_AUTHENTICATED_CONFIGURE_INPUT structure that contains the command GUID and other data. + The initial sequence number for queries. @@ -8306,11 +11486,15 @@ For more information about this number, see Remarks. Describes a compressed buffer for decoding. - Microsoft Docs: + + Microsoft Docs: + - The type of buffer, specified as a member of the D3D11_VIDEO_DECODER_BUFFER_TYPE enumeration. + + The type of buffer, specified as a member of the D3D11_VIDEO_DECODER_BUFFER_TYPE enumeration. + Reserved. @@ -8337,66 +11521,102 @@ For more information about this number, see Remarks. Reserved. Set to zero. - A pointer to a buffer that contains an initialization vector (IV) for encrypted data. If the decode buffer does not contain encrypted data, set this member to NULL. + + A pointer to a buffer that contains an initialization vector (IV) for encrypted data. If the decode buffer does not contain encrypted data, set this member to NULL. + - The size of the buffer specified in the pIV parameter. If pIV is NULL, set this member to zero. + + The size of the buffer specified in the pIV parameter. If pIV is NULL, set this member to zero. + - If TRUE, the video surfaces are partially encrypted. + + If TRUE, the video surfaces are partially encrypted. + - A D3D11_ENCRYPTED_BLOCK_INFO structure that specifies which bytes of the surface are encrypted. + + A D3D11_ENCRYPTED_BLOCK_INFO structure that specifies which bytes of the surface are encrypted. + A function-reflection interface accesses function info. - Microsoft Docs: + + Microsoft Docs: + Create a compute shader. - Microsoft Docs: + + Microsoft Docs: + A pointer to a compiled shader. - Size of the compiled shader in pShaderBytecode. - A pointer to a ID3D11ClassLinkage, which represents class linkage interface; the value can be NULL. - Address of a pointer to an ID3D11ComputeShader interface. If this is NULL, - all other parameters will be validated; if validation passes, CreateComputeShader returns S_FALSE instead of S_OK. + + Size of the compiled shader in pShaderBytecode. + + + A pointer to a ID3D11ClassLinkage, which represents class linkage interface; the value can be NULL. + + + Address of a pointer to an ID3D11ComputeShader interface. If this is NULL, + all other parameters will be validated; if validation passes, CreateComputeShader returns S_FALSE instead of S_OK. + Gets the description for rasterizer state that you used to create the rasterizer-state object. - Microsoft Docs: - A pointer to a D3D11_RASTERIZER_DESC2 structure that receives a description of the rasterizer state. This rasterizer state can specify forced sample count and conservative rasterization mode. + + Microsoft Docs: + + + A pointer to a D3D11_RASTERIZER_DESC2 structure that receives a description of the rasterizer state. This rasterizer state can specify forced sample count and conservative rasterization mode. + Gets a query description. - Microsoft Docs: - A pointer to a D3D11_QUERY_DESC1 structure that receives a description of the query. + + Microsoft Docs: + + + A pointer to a D3D11_QUERY_DESC1 structure that receives a description of the query. + Get the type of the resource. - Microsoft Docs: - Pointer to the resource type (see D3D11_RESOURCE_DIMENSION). + + Microsoft Docs: + + + Pointer to the resource type (see D3D11_RESOURCE_DIMENSION). + Contains the response from the ID3D11VideoContext::ConfigureAuthenticatedChannel method. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_OMAC structure that contains a Message Authentication Code (MAC) of the data. The driver uses AES-based one-key CBC MAC (OMAC) to calculate this value for the block of data that appears after this structure member. + + A D3D11_OMAC structure that contains a Message Authentication Code (MAC) of the data. The driver uses AES-based one-key CBC MAC (OMAC) to calculate this value for the block of data that appears after this structure member. + - A GUID that specifies the command. For a list of GUIDs, see D3D11_AUTHENTICATED_CONFIGURE_INPUT. + + A GUID that specifies the command. For a list of GUIDs, see D3D11_AUTHENTICATED_CONFIGURE_INPUT. + A handle to the authenticated channel. @@ -8410,14 +11630,20 @@ For more information about this number, see Remarks. Describes the content-protection capabilities of a graphics driver. - Microsoft Docs: + + Microsoft Docs: + - A bitwise OR of zero or more flags from the D3D11_CONTENT_PROTECTION_CAPS enumeration. + + A bitwise OR of zero or more flags from the D3D11_CONTENT_PROTECTION_CAPS enumeration. + - The number of cryptographic key-exchange types that are supported by the driver. To get the list of key-exchange types, call the ID3D11VideoDevice::CheckCryptoKeyExchange method. + + The number of cryptographic key-exchange types that are supported by the driver. To get the list of key-exchange types, call the ID3D11VideoDevice::CheckCryptoKeyExchange method. + The encyrption block size, in bytes. The size of data to be encrypted must be a multiple of this value. @@ -8428,47 +11654,73 @@ For more information about this number, see Remarks. Debug messages for setting up an info-queue filter (see D3D11_INFO_QUEUE_FILTER); use these messages to allow or deny message categories to pass through the storage and retrieval filters. - Microsoft Docs: + + Microsoft Docs: + Creates a geometry shader that can write to streaming output buffers. - Microsoft Docs: - A pointer to the compiled geometry shader for a standard geometry shader plus stream output. For info on how to get this pointer, see Getting a Pointer to a Compiled Shader. + + Microsoft Docs: + + + A pointer to the compiled geometry shader for a standard geometry shader plus stream output. For info on how to get this pointer, see Getting a Pointer to a Compiled Shader. -To create the stream output without using a geometry shader, pass a pointer to the output signature for the prior stage. To obtain this output signature, call the D3DGetOutputSignatureBlob compiler function. You can also pass a pointer to the compiled shader for the prior stage (for example, the vertex-shader stage or domain-shader stage). This compiled shader provides the output signature for the data. + To create the stream output without using a geometry shader, pass a pointer to the output signature for the prior stage. To obtain this output signature, call the D3DGetOutputSignatureBlob compiler function. You can also pass a pointer to the compiled shader for the prior stage (for example, the vertex-shader stage or domain-shader stage). This compiled shader provides the output signature for the data. + Size of the compiled geometry shader. - Pointer to a D3D11_SO_DECLARATION_ENTRY array. Cannot be NULL if NumEntries > 0. + + Pointer to a D3D11_SO_DECLARATION_ENTRY array. Cannot be NULL if NumEntries > 0. + The number of entries in the stream output declaration ( ranges from 0 to D3D11_SO_STREAM_COUNT * D3D11_SO_OUTPUT_COMPONENT_COUNT ). An array of buffer strides; each stride is the size of an element for that buffer. - The number of strides (or buffers) in pBufferStrides (ranges from 0 to D3D11_SO_BUFFER_SLOT_COUNT). - The index number of the stream to be sent to the rasterizer stage (ranges from 0 to D3D11_SO_STREAM_COUNT - 1). - Set to D3D11_SO_NO_RASTERIZED_STREAM if no stream is to be rasterized. - A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. - Address of a pointer to an ID3D11GeometryShader interface, representing the geometry shader that was created. - Set this to NULL to validate the other parameters; if validation passes, the method will return S_FALSE instead of S_OK. + + The number of strides (or buffers) in pBufferStrides (ranges from 0 to D3D11_SO_BUFFER_SLOT_COUNT). + + + The index number of the stream to be sent to the rasterizer stage (ranges from 0 to D3D11_SO_STREAM_COUNT - 1). + Set to D3D11_SO_NO_RASTERIZED_STREAM if no stream is to be rasterized. + + + A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. + + + Address of a pointer to an ID3D11GeometryShader interface, representing the geometry shader that was created. + Set this to NULL to validate the other parameters; if validation passes, the method will return S_FALSE instead of S_OK. + Get a message severity level to break on when a message with that severity level passes through the storage filter. - Microsoft Docs: - Message severity level to break on (see D3D11_MESSAGE_SEVERITY). + + Microsoft Docs: + + + Message severity level to break on (see D3D11_MESSAGE_SEVERITY). + Get an output-parameter description for a shader. - Microsoft Docs: + + Microsoft Docs: + A zero-based parameter index. - A pointer to a shader-output-parameter description. See D3D11_SIGNATURE_PARAMETER_DESC. + + A pointer to a shader-output-parameter description. See D3D11_SIGNATURE_PARAMETER_DESC. + Types of magnification or minification sampler filters. - Microsoft Docs: + + Microsoft Docs: + @@ -8480,7 +11732,9 @@ To create the stream output without using a geometry shader, pass a pointer to t Describes the elements in a buffer to use in a unordered-access view. - Microsoft Docs: + + Microsoft Docs: + @@ -8490,26 +11744,38 @@ To create the stream output without using a geometry shader, pass a pointer to t The number of elements in the resource. For structured buffers, this is the number of structures in the buffer. - View options for the resource (see D3D11_BUFFER_UAV_FLAG). + + View options for the resource (see D3D11_BUFFER_UAV_FLAG). + Fills the parameter descriptor structure for the function's parameter. - Microsoft Docs: - A pointer to a D3D11_PARAMETER_DESC structure that receives a description of the function's parameter. + + Microsoft Docs: + + + A pointer to a D3D11_PARAMETER_DESC structure that receives a description of the function's parameter. + Discards a resource from the device context. - Microsoft Docs: - A pointer to the ID3D11Resource interface for the resource to discard. The resource must have been created with usage D3D11_USAGE_DEFAULT or D3D11_USAGE_DYNAMIC, otherwise the runtime drops the call to DiscardResource; if the debug layer is enabled, the runtime returns an error message. + + Microsoft Docs: + + + A pointer to the ID3D11Resource interface for the resource to discard. The resource must have been created with usage D3D11_USAGE_DEFAULT or D3D11_USAGE_DYNAMIC, otherwise the runtime drops the call to DiscardResource; if the debug layer is enabled, the runtime returns an error message. + Describes a unordered-access 3D texture resource. - Microsoft Docs: + + Microsoft Docs: + @@ -8524,14 +11790,20 @@ To create the stream output without using a geometry shader, pass a pointer to t Gets the error from the last function call of the function-linking-graph. - Microsoft Docs: - An pointer to a variable that receives a pointer to the ID3DBlob interface that you can use to access the error. + + Microsoft Docs: + + + An pointer to a variable that receives a pointer to the ID3DBlob interface that you can use to access the error. + Specifies the subresource from a 2D texture that is accessible to a depth-stencil view. - Microsoft Docs: + + Microsoft Docs: + @@ -8540,68 +11812,104 @@ To create the stream output without using a geometry shader, pass a pointer to t Discards a resource view from the device context. - Microsoft Docs: - A pointer to the ID3D11View interface for the resource view to discard. The resource that underlies the view must have been created with usage D3D11_USAGE_DEFAULT or D3D11_USAGE_DYNAMIC, otherwise the runtime drops the call to DiscardView; if the debug layer is enabled, the runtime returns an error message. + + Microsoft Docs: + + + A pointer to the ID3D11View interface for the resource view to discard. The resource that underlies the view must have been created with usage D3D11_USAGE_DEFAULT or D3D11_USAGE_DYNAMIC, otherwise the runtime drops the call to DiscardView; if the debug layer is enabled, the runtime returns an error message. + Gets the number of interface slots in a shader. - Microsoft Docs: + + Microsoft Docs: + Gets the function parameter reflector. - Microsoft Docs: + + Microsoft Docs: + The zero-based index of the function parameter reflector to retrieve. Contains the response to a D3D11_AUTHENTICATED_QUERY_ACCESSIBILITY_ATTRIBUTES query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + - A bitwise OR of flags from the D3D11_BUS_TYPE enumeration. + + A bitwise OR of flags from the D3D11_BUS_TYPE enumeration. + - If TRUE, contiguous blocks of video memory may be accessible to the CPU or the bus. + + If TRUE, contiguous blocks of video memory may be accessible to the CPU or the bus. + - If TRUE, non-contiguous blocks of video memory may be accessible to the CPU or the bus. + + If TRUE, non-contiguous blocks of video memory may be accessible to the CPU or the bus. + Copy a multisampled resource into a non-multisampled resource. - Microsoft Docs: - Destination resource. Must be a created with the D3D11_USAGE_DEFAULT flag and be single-sampled. See ID3D11Resource. - A zero-based index, that identifies the destination subresource. Use D3D11CalcSubresource to calculate the index. + + Microsoft Docs: + + + Destination resource. Must be a created with the D3D11_USAGE_DEFAULT flag and be single-sampled. See ID3D11Resource. + + + A zero-based index, that identifies the destination subresource. Use D3D11CalcSubresource to calculate the index. + Source resource. Must be multisampled. The source subresource of the source resource. - A DXGI_FORMAT that indicates how the multisampled resource will be resolved to a single-sampled resource. - See remarks. + + A DXGI_FORMAT that indicates how the multisampled resource will be resolved to a single-sampled resource. + See remarks. + Performs a video processing operation on one or more input samples and writes the result to a Direct3D surface. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call the ID3D11VideoDevice::CreateVideoProcessor method. - A pointer to the ID3D11VideoProcessorOutputView interface for the output surface. The output of the video processing operation will be written to this surface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call the ID3D11VideoDevice::CreateVideoProcessor method. + + + A pointer to the ID3D11VideoProcessorOutputView interface for the output surface. The output of the video processing operation will be written to this surface. + The frame number of the output video frame, indexed from zero. The number of input streams to process. - A pointer to an array of D3D11_VIDEO_PROCESSOR_STREAM structures that contain information about the input streams. The caller allocates the array and fills in each structure. The number of elements in the array is given in the StreamCount parameter. + + A pointer to an array of D3D11_VIDEO_PROCESSOR_STREAM structures that contain information about the input streams. The caller allocates the array and fills in each structure. The number of elements in the array is given in the StreamCount parameter. + Describes how a video stream is interlaced. - Microsoft Docs: + + Microsoft Docs: + @@ -8616,43 +11924,62 @@ To create the stream output without using a geometry shader, pass a pointer to t Get a shader-reflection-variable type by index. - Microsoft Docs: + + Microsoft Docs: + Zero-based index. Gets a cryptographic key-exchange mechanism that is supported by the driver. - Microsoft Docs: - A pointer to a GUID that specifies the type of encryption to be used. The following GUIDs are defined. + + Microsoft Docs: + + + A pointer to a GUID that specifies the type of encryption to be used. The following GUIDs are defined. - - - - - - - - + +
ValueMeaning
-
D3D11_CRYPTO_TYPE_AES128_CTR
-
-		 -128-bit Advanced Encryption Standard CTR mode (AES-CTR) block cipher. + + + + + + + + - -
ValueMeaning
+ + +
+
+ D3D11_CRYPTO_TYPE_AES128_CTR +
+
+ 		+ 128-bit Advanced Encryption Standard CTR mode (AES-CTR) block cipher. -
- A pointer to a GUID that specifies the decoding profile. To get profiles that the driver supports, call ID3D11VideoDevice::GetVideoDecoderProfile. If decoding will not be used, set this parameter to NULL. - The zero-based index of the key-exchange type. The driver reports the number of types in the KeyExchangeTypeCount member of the D3D11_VIDEO_CONTENT_PROTECTION_CAPS structure. +
+ + + A pointer to a GUID that specifies the decoding profile. To get profiles that the driver supports, call ID3D11VideoDevice::GetVideoDecoderProfile. If decoding will not be used, set this parameter to NULL. + + + The zero-based index of the key-exchange type. The driver reports the number of types in the KeyExchangeTypeCount member of the D3D11_VIDEO_CONTENT_PROTECTION_CAPS structure. + Receives a GUID that identifies the type of key exchange. Indicates that decoder downsampling will be used and that the driver should allocate the appropriate reference frames. - Microsoft Docs: - A pointer to the ID3D11VideoDecoder interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoDecoder interface. + The color space information of the reference frame data. The resolution, format, and colorspace of the output/display frames. This is the destination resolution and format of the downsample operation. The number of reference frames to be used in the operation. @@ -8661,65 +11988,89 @@ To create the stream output without using a geometry shader, pass a pointer to t Gets a variable by name. - Microsoft Docs: + + Microsoft Docs: + A pointer to a string containing the variable name. Describes a shader-trace object. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_SHADER_TYPE-typed value that identifies the type of shader that the shader-trace object describes. This member also determines which shader-trace type to use in the following union. + + A D3D11_SHADER_TYPE-typed value that identifies the type of shader that the shader-trace object describes. This member also determines which shader-trace type to use in the following union. + - A combination of the following flags that are combined by using a bitwise OR operation. The resulting value specifies how ID3D11ShaderTraceFactory::CreateShaderTrace creates the shader-trace object. + + A combination of the following flags that are combined by using a bitwise OR operation. The resulting value specifies how ID3D11ShaderTraceFactory::CreateShaderTrace creates the shader-trace object. - - - - - - - - - - - - - -
FlagDescription
D3D11_SHADER_TRACE_FLAG_RECORD_REGISTER_WRITES (0x1)The shader trace object records register-writes.
D3D11_SHADER_TRACE_FLAG_RECORD_REGISTER_READS (0x2)The shader trace object records register-reads.
 + + + + + + + + + + + + + +
FlagDescription
D3D11_SHADER_TRACE_FLAG_RECORD_REGISTER_WRITES (0x1)The shader trace object records register-writes.
D3D11_SHADER_TRACE_FLAG_RECORD_REGISTER_READS (0x2)The shader trace object records register-reads.
+ - A D3D11_VERTEX_SHADER_TRACE_DESC structure that describes an instance of a vertex shader to trace. + + A D3D11_VERTEX_SHADER_TRACE_DESC structure that describes an instance of a vertex shader to trace. + - A D3D11_HULL_SHADER_TRACE_DESC structure that describes an instance of a hull shader to trace. + + A D3D11_HULL_SHADER_TRACE_DESC structure that describes an instance of a hull shader to trace. + - A D3D11_DOMAIN_SHADER_TRACE_DESC structure that describes an instance of a domain shader to trace. + + A D3D11_DOMAIN_SHADER_TRACE_DESC structure that describes an instance of a domain shader to trace. + - A D3D11_GEOMETRY_SHADER_TRACE_DESC structure that describes an instance of a geometry shader to trace. + + A D3D11_GEOMETRY_SHADER_TRACE_DESC structure that describes an instance of a geometry shader to trace. + - A D3D11_PIXEL_SHADER_TRACE_DESC structure that describes an instance of a pixel shader to trace. + + A D3D11_PIXEL_SHADER_TRACE_DESC structure that describes an instance of a pixel shader to trace. + - A D3D11_COMPUTE_SHADER_TRACE_DESC structure that describes an instance of a compute shader to trace. + + A D3D11_COMPUTE_SHADER_TRACE_DESC structure that describes an instance of a compute shader to trace. + Gets the initialization flags associated with the current deferred context. - Microsoft Docs: + + Microsoft Docs: + Rebinds a resource by name as an unordered access view (UAV) to destination slots. - Microsoft Docs: + + Microsoft Docs: + The name of the resource for rebinding. The first destination slot number for rebinding. The number of slots for rebinding. @@ -8728,17 +12079,23 @@ To create the stream output without using a geometry shader, pass a pointer to t Provides a communication channel with the graphics driver or the Microsoft Direct3D runtime. - Microsoft Docs: + + Microsoft Docs: + Contains the response to a D3D11_AUTHENTICATED_QUERY_UNRESTRICTED_PROTECTED_SHARED_RESOURCE_COUNT query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + The number of protected, shared resources that can be opened by any process without restrictions. @@ -8746,112 +12103,169 @@ To create the stream output without using a geometry shader, pass a pointer to t Get a counter description. - Microsoft Docs: - Pointer to a counter description (see D3D11_COUNTER_DESC). + + Microsoft Docs: + + + Pointer to a counter description (see D3D11_COUNTER_DESC). + Gets the format of an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Receives a D3D11_VIDEO_FRAME_FORMAT value that specifies whether the stream contains interlaced or progressive frames. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Receives a D3D11_VIDEO_FRAME_FORMAT value that specifies whether the stream contains interlaced or progressive frames. + Get an array of sampler states from the pixel shader pipeline stage. - Microsoft Docs: + + Microsoft Docs: + Index into a zero-based array to begin getting samplers from (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers to get from a device context. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Arry of sampler-state interface pointers (see ID3D11SamplerState) to be returned by the device. + + Arry of sampler-state interface pointers (see ID3D11SamplerState) to be returned by the device. + Get the reason why the device was removed. - Microsoft Docs: + + Microsoft Docs: + Describes a 2D texture. - Microsoft Docs: + + Microsoft Docs: + - Texture width (in texels). The range is from 1 to D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). For a texture cube-map, the range is from 1 to D3D11_REQ_TEXTURECUBE_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Texture width (in texels). The range is from 1 to D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). For a texture cube-map, the range is from 1 to D3D11_REQ_TEXTURECUBE_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - Texture height (in texels). The range is from 1 to D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). For a texture cube-map, the range is from 1 to D3D11_REQ_TEXTURECUBE_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Texture height (in texels). The range is from 1 to D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). For a texture cube-map, the range is from 1 to D3D11_REQ_TEXTURECUBE_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - The maximum number of mipmap levels in the texture. See the remarks in D3D11_TEX1D_SRV. Use 1 for a multisampled texture; or 0 to generate a full set of subtextures. + + The maximum number of mipmap levels in the texture. See the remarks in D3D11_TEX1D_SRV. Use 1 for a multisampled texture; or 0 to generate a full set of subtextures. + - Number of textures in the texture array. The range is from 1 to D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048). For a texture cube-map, this value is a multiple of 6 (that is, 6 times the value in the NumCubes member of D3D11_TEXCUBE_ARRAY_SRV), and the range is from 6 to 2046. The range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Number of textures in the texture array. The range is from 1 to D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048). For a texture cube-map, this value is a multiple of 6 (that is, 6 times the value in the NumCubes member of D3D11_TEXCUBE_ARRAY_SRV), and the range is from 6 to 2046. The range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - Texture format (see DXGI_FORMAT). + + Texture format (see DXGI_FORMAT). + - Structure that specifies multisampling parameters for the texture. See DXGI_SAMPLE_DESC. + + Structure that specifies multisampling parameters for the texture. See DXGI_SAMPLE_DESC. + - Value that identifies how the texture is to be read from and written to. The most common value is D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + + Value that identifies how the texture is to be read from and written to. The most common value is D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + - Flags (see D3D11_BIND_FLAG) for binding to pipeline stages. The flags can be combined by a logical OR. + + Flags (see D3D11_BIND_FLAG) for binding to pipeline stages. The flags can be combined by a logical OR. + - Flags (see D3D11_CPU_ACCESS_FLAG) to specify the types of CPU access allowed. Use 0 if CPU access is not required. These flags can be combined with a logical OR. + + Flags (see D3D11_CPU_ACCESS_FLAG) to specify the types of CPU access allowed. Use 0 if CPU access is not required. These flags can be combined with a logical OR. + - Flags (see D3D11_RESOURCE_MISC_FLAG) that identify other, less common resource options. Use 0 if none of these flags apply. These flags can be combined by using a logical OR. For a texture cube-map, set the D3D11_RESOURCE_MISC_TEXTURECUBE flag. Cube-map arrays (that is, ArraySize > 6) require feature level D3D_FEATURE_LEVEL_10_1 or higher. + + Flags (see D3D11_RESOURCE_MISC_FLAG) that identify other, less common resource options. Use 0 if none of these flags apply. These flags can be combined by using a logical OR. For a texture cube-map, set the D3D11_RESOURCE_MISC_TEXTURECUBE flag. Cube-map arrays (that is, ArraySize > 6) require feature level D3D_FEATURE_LEVEL_10_1 or higher. + Queries the driver for its content protection capabilities. - Microsoft Docs: - A pointer to a GUID that specifies the type of encryption to be used. The following GUIDs are defined. + + Microsoft Docs: + + + A pointer to a GUID that specifies the type of encryption to be used. The following GUIDs are defined. - - - - - - - - + +
ValueMeaning
-
D3D11_CRYPTO_TYPE_AES128_CTR
-
-		 -128-bit Advanced Encryption Standard CTR mode (AES-CTR) block cipher. + + + + + + + + - -
ValueMeaning
+ + +
+
+ D3D11_CRYPTO_TYPE_AES128_CTR +
+
+ 		+ 128-bit Advanced Encryption Standard CTR mode (AES-CTR) block cipher. -
-  +
+   -If no encryption will be used, set this parameter to NULL. - A pointer to a GUID that specifies the decoding profile. To get profiles that the driver supports, call ID3D11VideoDevice::GetVideoDecoderProfile. If decoding will not be used, set this parameter to NULL. + If no encryption will be used, set this parameter to NULL. + + + A pointer to a GUID that specifies the decoding profile. To get profiles that the driver supports, call ID3D11VideoDevice::GetVideoDecoderProfile. If decoding will not be used, set this parameter to NULL. -The driver might disallow some combinations of encryption type and profile. - A pointer to a D3D11_VIDEO_CONTENT_PROTECTION_CAPS structure. The method fills in this structure with the driver's content protection capabilities. + The driver might disallow some combinations of encryption type and profile. + + + A pointer to a D3D11_VIDEO_CONTENT_PROTECTION_CAPS structure. The method fills in this structure with the driver's content protection capabilities. + Remove a storage filter from the top of the storage-filter stack. - Microsoft Docs: + + Microsoft Docs: + Rebinds an unordered access view (UAV) from source slot to destination slot. - Microsoft Docs: + + Microsoft Docs: + The first source slot number for rebinding. The first destination slot number for rebinding. The number of slots for rebinding. @@ -8860,26 +12274,36 @@ The driver might disallow some combinations of encryption type and profile. Set an array of sampler states to the hull-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the zero-based array to begin setting samplers to (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers in the array. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + + Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + The device interface represents a virtual adapter; it is used to create resources. ID3D11Device1 adds new methods to those in ID3D11Device. - Microsoft Docs: + + Microsoft Docs: + Specifies a range of tile mappings to use with ID3D11DeviceContext2::UpdateTiles. - Microsoft Docs: + + Microsoft Docs: + - The tile range is NULL. + + The tile range is NULL. + Skip the tile range. @@ -8890,41 +12314,59 @@ The driver might disallow some combinations of encryption type and profile. Provides threading protection for critical sections of a multi-threaded application. - Microsoft Docs: + + Microsoft Docs: + Execute a command list from a thread group. - Microsoft Docs: - The number of groups dispatched in the x direction. ThreadGroupCountX must be less than or equal to D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). - The number of groups dispatched in the y direction. ThreadGroupCountY must be less than or equal to D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). - The number of groups dispatched in the z direction. ThreadGroupCountZ must be less than or equal to D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). - In feature level 10 the value for ThreadGroupCountZ must be 1. + + Microsoft Docs: + + + The number of groups dispatched in the x direction. ThreadGroupCountX must be less than or equal to D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). + + + The number of groups dispatched in the y direction. ThreadGroupCountY must be less than or equal to D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). + + + The number of groups dispatched in the z direction. ThreadGroupCountZ must be less than or equal to D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). + In feature level 10 the value for ThreadGroupCountZ must be 1. + Allows apps to determine when either a capture or profiling request is enabled. - Microsoft Docs: + + Microsoft Docs: + Handles the creation, wrapping, and releasing of D3D11 resources for Direct3D11on12. - Microsoft Docs: + + Microsoft Docs: + A shader-resource-view interface specifies the subresources a shader can access during rendering. Examples of shader resources include a constant buffer, a texture buffer, and a texture. - Microsoft Docs: + + Microsoft Docs: + Comparison options. - Microsoft Docs: + + Microsoft Docs: + @@ -8954,58 +12396,88 @@ The driver might disallow some combinations of encryption type and profile. Draw geometry of an unknown size. - Microsoft Docs: + + Microsoft Docs: + Queries whether the video processor produces stereo video frames. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - Receives the value TRUE if stereo output is enabled, or FALSE otherwise. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + Receives the value TRUE if stereo output is enabled, or FALSE otherwise. + Get an array of sampler states from the vertex shader pipeline stage. - Microsoft Docs: + + Microsoft Docs: + Index into a zero-based array to begin getting samplers from (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers to get from a device context. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Arry of sampler-state interface pointers (see ID3D11SamplerState) to be returned by the device. + + Arry of sampler-state interface pointers (see ID3D11SamplerState) to be returned by the device. + Push a copy of storage filter currently on the top of the storage-filter stack onto the storage-filter stack. - Microsoft Docs: + + Microsoft Docs: + Get a counter's information. - Microsoft Docs: - Pointer to counter information (see D3D11_COUNTER_INFO). + + Microsoft Docs: + + + Pointer to counter information (see D3D11_COUNTER_INFO). + ID3D11SwitchToRef::GetUseRef method - Microsoft Docs: + + Microsoft Docs: + Sets the constant buffers used by the geometry shader pipeline stage. - Microsoft Docs: - Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffers (see ID3D11Buffer) being given to the device. + + Microsoft Docs: + + + Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). + + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + + Array of constant buffers (see ID3D11Buffer) being given to the device. + Specifies if the hardware and driver support conservative rasterization and at what tier level. - Microsoft Docs: + + Microsoft Docs: + @@ -9023,44 +12495,61 @@ The driver might disallow some combinations of encryption type and profile. A query interface queries information from the GPU. - Microsoft Docs: + + Microsoft Docs: + Gets the class-instance object that represents the specified HLSL class. - Microsoft Docs: + + Microsoft Docs: + The name of a class for which to get the class instance. The index of the class instance. - The address of a pointer to an ID3D11ClassInstance interface to initialize. + + The address of a pointer to an ID3D11ClassInstance interface to initialize. + Describes which resources are supported by the current graphics driver for a given format. - Microsoft Docs: + + Microsoft Docs: + -DXGI_FORMAT to return information on. + DXGI_FORMAT to return information on. + - Combination of D3D11_FORMAT_SUPPORT flags indicating which resources are supported. + + Combination of D3D11_FORMAT_SUPPORT flags indicating which resources are supported. + Describes Direct3D 9 feature options in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether the driver supports the nonpowers-of-2-unconditionally feature. For more information about this feature, see feature level. The runtime sets this member to TRUE for hardware at Direct3D 10 and higher feature levels. For hardware at Direct3D 9.3 and lower feature levels, the runtime sets this member to FALSE if the hardware and driver support the powers-of-2 (2D textures must have widths and heights specified as powers of two) feature or the nonpowers-of-2-conditionally feature. For more information about this feature, see feature level. + + Specifies whether the driver supports the nonpowers-of-2-unconditionally feature. For more information about this feature, see feature level. The runtime sets this member to TRUE for hardware at Direct3D 10 and higher feature levels. For hardware at Direct3D 9.3 and lower feature levels, the runtime sets this member to FALSE if the hardware and driver support the powers-of-2 (2D textures must have widths and heights specified as powers of two) feature or the nonpowers-of-2-conditionally feature. For more information about this feature, see feature level. + Options for performance counters. - Microsoft Docs: + + Microsoft Docs: + @@ -9069,18 +12558,28 @@ The driver might disallow some combinations of encryption type and profile. Gets the constant buffers that the hull-shader stage uses. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + Array of constant buffer interface pointers to be returned by the method. - A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. - A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + + A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. + + + A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + Specifies how a video format can be used for video processing. - Microsoft Docs: + + Microsoft Docs: + @@ -9092,7 +12591,9 @@ The driver might disallow some combinations of encryption type and profile. Rebinds a sampler by name to destination slots. - Microsoft Docs: + + Microsoft Docs: + The name of the sampler for rebinding. The first destination slot number for rebinding. The number of slots for rebinding. @@ -9101,28 +12602,42 @@ The driver might disallow some combinations of encryption type and profile. Gets an array of views for an unordered resource. - Microsoft Docs: + + Microsoft Docs: + Index of the first element in the zero-based array to return (ranges from 0 to D3D11_1_UAV_SLOT_COUNT - 1). Number of views to get (ranges from 0 to D3D11_1_UAV_SLOT_COUNT - StartSlot). - A pointer to an array of interface pointers (see ID3D11UnorderedAccessView) to get. + + A pointer to an array of interface pointers (see ID3D11UnorderedAccessView) to get. + Gets a value indicating whether the output surface from a call to ID3D11VideoContext::VideoProcessorBlt can be read by Direct3D shaders. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. - A pointer to a boolean value indicating if the output surface can be read by Direct3D shaders. True if the surface rendered using ID3D11VideoContext::VideoProcessorBlt can be read by Direct3D shaders; otherwise, false. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + + + A pointer to a boolean value indicating if the output surface can be read by Direct3D shaders. True if the surface rendered using ID3D11VideoContext::VideoProcessorBlt can be read by Direct3D shaders; otherwise, false. + Specifies how to access a resource used in a depth-stencil view. - Microsoft Docs: + + Microsoft Docs: + - D3D11_DSV_DIMENSION_UNKNOWN is not a valid value for D3D11_DEPTH_STENCIL_VIEW_DESC and is not used. + + D3D11_DSV_DIMENSION_UNKNOWN is not a valid value for D3D11_DEPTH_STENCIL_VIEW_DESC and is not used. + The resource will be accessed as a 1D texture. @@ -9145,14 +12660,20 @@ The driver might disallow some combinations of encryption type and profile. Fills the library descriptor structure for the library reflection. - Microsoft Docs: - A pointer to a D3D11_LIBRARY_DESC structure that receives a description of the library reflection. + + Microsoft Docs: + + + A pointer to a D3D11_LIBRARY_DESC structure that receives a description of the library reflection. + Specifies the automatic image processing capabilities of the video processor. - Microsoft Docs: + + Microsoft Docs: + @@ -9182,91 +12703,135 @@ The driver might disallow some combinations of encryption type and profile. Sets the HDR metadata associated with the video stream. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + Identifies the input stream. The type of HDR metadata supplied. - The size of the HDR metadata supplied in pHDRMetaData. + + The size of the HDR metadata supplied in pHDRMetaData. -For DXGI_HDR_METADATA_TYPE_NONE, the size should be 0. + For DXGI_HDR_METADATA_TYPE_NONE, the size should be 0. -For DXGI_HDR_METADATA_TYPE_HDR10, the size is sizeof(DXGI_HDR_METADATA_HDR10). - Pointer to the metadata information. + For DXGI_HDR_METADATA_TYPE_HDR10, the size is sizeof(DXGI_HDR_METADATA_HDR10). + + + Pointer to the metadata information. -For DXGI_HDR_METADATA_TYPE_NONE, this should be NULL. + For DXGI_HDR_METADATA_TYPE_NONE, this should be NULL. -For DXGI_HDR_METADATA_TYPE_HDR10, this is a pointer to a DXGI_HDR_METADATA_HDR10 structure. + For DXGI_HDR_METADATA_TYPE_HDR10, this is a pointer to a DXGI_HDR_METADATA_HDR10 structure. + Describes the subresources from a resource that are accessible using a render-target view. - Microsoft Docs: + + Microsoft Docs: + - A DXGI_FORMAT-typed value that specifies the data format. + + A DXGI_FORMAT-typed value that specifies the data format. + - A D3D11_RTV_DIMENSION-typed value that specifies the resource type and how the render-target resource will be accessed. + + A D3D11_RTV_DIMENSION-typed value that specifies the resource type and how the render-target resource will be accessed. + - A D3D11_BUFFER_RTV structure that specifies which buffer elements can be accessed. + + A D3D11_BUFFER_RTV structure that specifies which buffer elements can be accessed. + - A D3D11_TEX1D_RTV structure that specifies the subresources in a 1D texture that can be accessed. + + A D3D11_TEX1D_RTV structure that specifies the subresources in a 1D texture that can be accessed. + - A D3D11_TEX1D_ARRAY_RTV structure that specifies the subresources in a 1D texture array that can be accessed. + + A D3D11_TEX1D_ARRAY_RTV structure that specifies the subresources in a 1D texture array that can be accessed. + - A D3D11_TEX2D_RTV1 structure that specifies the subresources in a 2D texture that can be accessed. + + A D3D11_TEX2D_RTV1 structure that specifies the subresources in a 2D texture that can be accessed. + - A D3D11_TEX2D_ARRAY_RTV1 structure that specifies the subresources in a 2D texture array that can be accessed. + + A D3D11_TEX2D_ARRAY_RTV1 structure that specifies the subresources in a 2D texture array that can be accessed. + - A D3D11_TEX2DMS_RTV structure that specifies a single subresource because a multisampled 2D texture only contains one subresource. + + A D3D11_TEX2DMS_RTV structure that specifies a single subresource because a multisampled 2D texture only contains one subresource. + - A D3D11_TEX2DMS_ARRAY_RTV structure that specifies the subresources in a multisampled 2D texture array that can be accessed. + + A D3D11_TEX2DMS_ARRAY_RTV structure that specifies the subresources in a multisampled 2D texture array that can be accessed. + - A D3D11_TEX3D_RTV structure that specifies subresources in a 3D texture that can be accessed. + + A D3D11_TEX3D_RTV structure that specifies subresources in a 3D texture that can be accessed. + The device interface represents a virtual adapter; it is used to create resources. ID3D11Device5 adds new methods to those in ID3D11Device4. - Microsoft Docs: + + Microsoft Docs: + Get the number of messages currently stored in the message queue. - Microsoft Docs: + + Microsoft Docs: + ID3D11SwitchToRef::SetUseRef method - Microsoft Docs: + + Microsoft Docs: + Reserved. Create a hull shader. - Microsoft Docs: + + Microsoft Docs: + A pointer to a compiled shader. Size of the compiled shader. - A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. - Address of a pointer to a ID3D11HullShader interface. + + A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. + + + Address of a pointer to a ID3D11HullShader interface. + Depth-stencil view options. - Microsoft Docs: + + Microsoft Docs: + @@ -9278,59 +12843,89 @@ For DXGI_HDR_METADATA_TYPE_HDR10, this is a pointer to a Creates a resource view for a video processor, describing the output sample for the video processing operation. - Microsoft Docs: - A pointer to the ID3D11Resource interface of the output surface. The resource must be created with the D3D11_BIND_RENDER_TARGET flag. See D3D11_BIND_FLAG. - A pointer to the ID3D11VideoProcessorEnumerator interface that specifies the video processor. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessorEnumerator. - A pointer to a D3D11_VIDEO_PROCESSOR_OUTPUT_VIEW_DESC structure that describes the view. - Receives a pointer to the ID3D11VideoProcessorOutputView interface. The caller must release the resource. If this parameter is NULL, the method checks whether the view is supported, but does not create the view. + + Microsoft Docs: + + + A pointer to the ID3D11Resource interface of the output surface. The resource must be created with the D3D11_BIND_RENDER_TARGET flag. See D3D11_BIND_FLAG. + + + A pointer to the ID3D11VideoProcessorEnumerator interface that specifies the video processor. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessorEnumerator. + + + A pointer to a D3D11_VIDEO_PROCESSOR_OUTPUT_VIEW_DESC structure that describes the view. + + + Receives a pointer to the ID3D11VideoProcessorOutputView interface. The caller must release the resource. If this parameter is NULL, the method checks whether the view is supported, but does not create the view. + Provides the video functionality of a Microsoft Direct3D 11 device. - Microsoft Docs: + + Microsoft Docs: + Get the number of messages that were allowed to pass through a storage filter. - Microsoft Docs: + + Microsoft Docs: + Identifies a resource to be accessed for reading and writing by the CPU. Applications may combine one or more of these flags. - Microsoft Docs: + + Microsoft Docs: + - Resource is mapped for reading. The resource must have been created with read access - (see D3D11_CPU_ACCESS_READ). + + Resource is mapped for reading. The resource must have been created with read access + (see D3D11_CPU_ACCESS_READ). + - Resource is mapped for writing. The resource must have been created with write - access (see D3D11_CPU_ACCESS_WRITE). + + Resource is mapped for writing. The resource must have been created with write + access (see D3D11_CPU_ACCESS_WRITE). + - Resource is mapped for reading and writing. The resource must have been created with read and write - access (see D3D11_CPU_ACCESS_READ and D3D11_CPU_ACCESS_WRITE). + + Resource is mapped for reading and writing. The resource must have been created with read and write + access (see D3D11_CPU_ACCESS_READ and D3D11_CPU_ACCESS_WRITE). + - Resource is mapped for writing; the previous contents of the resource will be undefined. The resource must have been created with write access - and dynamic usage (See D3D11_CPU_ACCESS_WRITE and D3D11_USAGE_DYNAMIC). + + Resource is mapped for writing; the previous contents of the resource will be undefined. The resource must have been created with write access + and dynamic usage (See D3D11_CPU_ACCESS_WRITE and D3D11_USAGE_DYNAMIC). + - Resource is mapped for writing; the existing contents of the resource cannot be overwritten (see Remarks). This flag is only valid on vertex and - index buffers. The resource must have been created with write access (see D3D11_CPU_ACCESS_WRITE). + + Resource is mapped for writing; the existing contents of the resource cannot be overwritten (see Remarks). This flag is only valid on vertex and + index buffers. The resource must have been created with write access (see D3D11_CPU_ACCESS_WRITE). Cannot be used on a resource created with the D3D11_BIND_CONSTANT_BUFFER flag. -
Note  The Direct3D 11.1 runtime, which is available starting with Windows 8, enables mapping dynamic constant buffers and shader resource views (SRVs) of dynamic buffers with D3D11_MAP_WRITE_NO_OVERWRITE. The Direct3D 11 and earlier runtimes limited mapping to vertex or index buffers. To determine if a Direct3D device supports these features, call ID3D11Device::CheckFeatureSupport with D3D11_FEATURE_D3D11_OPTIONS. CheckFeatureSupport fills members of a D3D11_FEATURE_DATA_D3D11_OPTIONS structure with the device's features. The relevant members here are MapNoOverwriteOnDynamicConstantBuffer and MapNoOverwriteOnDynamicBufferSRV.
-
 
 +
+ Note  The Direct3D 11.1 runtime, which is available starting with Windows 8, enables mapping dynamic constant buffers and shader resource views (SRVs) of dynamic buffers with D3D11_MAP_WRITE_NO_OVERWRITE. The Direct3D 11 and earlier runtimes limited mapping to vertex or index buffers. To determine if a Direct3D device supports these features, call ID3D11Device::CheckFeatureSupport with D3D11_FEATURE_D3D11_OPTIONS. CheckFeatureSupport fills members of a D3D11_FEATURE_DATA_D3D11_OPTIONS structure with the device's features. The relevant members here are MapNoOverwriteOnDynamicConstantBuffer and MapNoOverwriteOnDynamicBufferSRV. +
+
 
+ Describes a unordered-access 2D texture resource. - Microsoft Docs: + + Microsoft Docs: + @@ -9339,7 +12934,9 @@ For DXGI_HDR_METADATA_TYPE_HDR10, this is a pointer to a Describes an array of unordered-access 2D texture resources. - Microsoft Docs: + + Microsoft Docs: + @@ -9357,46 +12954,68 @@ For DXGI_HDR_METADATA_TYPE_HDR10, this is a pointer to a Creates a 2D texture. - Microsoft Docs: - A pointer to a D3D11_TEXTURE2D_DESC1 structure that describes a 2D texture resource. To create a typeless resource that can be interpreted at runtime into different, compatible formats, specify a typeless format in the texture description. To generate mipmap levels automatically, set the number of mipmap levels to 0. - A pointer to an array of D3D11_SUBRESOURCE_DATA structures that describe subresources for the 2D texture resource. Applications can't specify NULL for pInitialData when creating IMMUTABLE resources (see D3D11_USAGE). If the resource is multisampled, pInitialData must be NULL because multisampled resources can't be initialized with data when they're created. + + Microsoft Docs: + + + A pointer to a D3D11_TEXTURE2D_DESC1 structure that describes a 2D texture resource. To create a typeless resource that can be interpreted at runtime into different, compatible formats, specify a typeless format in the texture description. To generate mipmap levels automatically, set the number of mipmap levels to 0. + + + A pointer to an array of D3D11_SUBRESOURCE_DATA structures that describe subresources for the 2D texture resource. Applications can't specify NULL for pInitialData when creating IMMUTABLE resources (see D3D11_USAGE). If the resource is multisampled, pInitialData must be NULL because multisampled resources can't be initialized with data when they're created. -If you don't pass anything to pInitialData, the initial content of the memory for the resource is undefined. In this case, you need to write the resource content some other way before the resource is read. + If you don't pass anything to pInitialData, the initial content of the memory for the resource is undefined. In this case, you need to write the resource content some other way before the resource is read. -You can determine the size of this array from values in the MipLevels and ArraySize members of the D3D11_TEXTURE2D_DESC1 structure to which pDesc1 points by using the following calculation: + You can determine the size of this array from values in the MipLevels and ArraySize members of the D3D11_TEXTURE2D_DESC1 structure to which pDesc1 points by using the following calculation: -MipLevels * ArraySize + MipLevels * ArraySize -For more info about this array size, see Remarks. - A pointer to a memory block that receives a pointer to a ID3D11Texture2D1 interface for the created texture. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + For more info about this array size, see Remarks. + + + A pointer to a memory block that receives a pointer to a ID3D11Texture2D1 interface for the created texture. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Discards the specified elements in a resource view from the device context. - Microsoft Docs: - A pointer to the ID3D11View interface for the resource view to discard. The resource that underlies the view must have been created with usage D3D11_USAGE_DEFAULT or D3D11_USAGE_DYNAMIC, otherwise the runtime drops the call to DiscardView1; if the debug layer is enabled, the runtime returns an error message. - An array of D3D11_RECT structures for the rectangles in the resource view to discard. If NULL, DiscardView1 discards the entire view and behaves the same as DiscardView. - Number of rectangles in the array that the pRects parameter specifies. + + Microsoft Docs: + + + A pointer to the ID3D11View interface for the resource view to discard. The resource that underlies the view must have been created with usage D3D11_USAGE_DEFAULT or D3D11_USAGE_DYNAMIC, otherwise the runtime drops the call to DiscardView1; if the debug layer is enabled, the runtime returns an error message. + + + An array of D3D11_RECT structures for the rectangles in the resource view to discard. If NULL, DiscardView1 discards the entire view and behaves the same as DiscardView. + + + Number of rectangles in the array that the pRects parameter specifies. + This shader-reflection interface provides access to a variable. - Microsoft Docs: + + Microsoft Docs: + Describes a shader constant-buffer. - Microsoft Docs: + + Microsoft Docs: + The name of the buffer. - A D3D_CBUFFER_TYPE-typed value that indicates the intended use of the constant data. + + A D3D_CBUFFER_TYPE-typed value that indicates the intended use of the constant data. + The number of unique variables. @@ -9405,49 +13024,71 @@ For more info about this array size, see Remarks. Buffer size (in bytes). - A combination of D3D_SHADER_CBUFFER_FLAGS-typed values that are combined by using a bitwise OR operation. The resulting value specifies properties for the shader constant-buffer. + + A combination of D3D_SHADER_CBUFFER_FLAGS-typed values that are combined by using a bitwise OR operation. The resulting value specifies properties for the shader constant-buffer. + Specifies a custom rate for frame-rate conversion or inverse telecine (IVTC). - Microsoft Docs: + + Microsoft Docs: + - The ratio of the output frame rate to the input frame rate, expressed as a DXGI_RATIONAL structure that holds a rational number. + + The ratio of the output frame rate to the input frame rate, expressed as a DXGI_RATIONAL structure that holds a rational number. + - The number of output frames that will be generated for every N input samples, where N = InputFramesOrFields. + + The number of output frames that will be generated for every N input samples, where N = InputFramesOrFields. + - If TRUE, the input stream must be interlaced. Otherwise, the input stream must be progressive. + + If TRUE, the input stream must be interlaced. Otherwise, the input stream must be progressive. + - The number of input fields or frames for every N output frames that will be generated, where N = OutputFrames. + + The number of input fields or frames for every N output frames that will be generated, where N = OutputFrames. + Enables you to take resources created through the Direct3D 11 APIs, and use them in Direct3D 12. - Microsoft Docs: + + Microsoft Docs: + Represents a cryptographic session. - Microsoft Docs: + + Microsoft Docs: + Gets the description for rasterizer state that you used to create the rasterizer-state object. - Microsoft Docs: - A pointer to a D3D11_RASTERIZER_DESC structure that receives a description of the rasterizer state. + + Microsoft Docs: + + + A pointer to a D3D11_RASTERIZER_DESC structure that receives a description of the rasterizer state. + Defines the range of supported values for an image filter. - Microsoft Docs: + + Microsoft Docs: + @@ -9460,22 +13101,30 @@ For more info about this array size, see Remarks. The default value of the filter. - A multiplier. Use the following formula to translate the filter setting into the actual filter value: Actual Value = Set Value × Multiplier. + + A multiplier. Use the following formula to translate the filter setting into the actual filter value: Actual Value = Set Value × Multiplier. + Describes flags that are used to create a device context state object (ID3DDeviceContextState) with the ID3D11Device1::CreateDeviceContextState method. - Microsoft Docs: + + Microsoft Docs: + - You use this flag if your application will only call methods of Direct3D 11 and Direct3D 10 interfaces from a single thread. By default, Direct3D 11 and Direct3D 10 are thread-safe. - By using this flag, you can increase performance. However, if you use this flag and your application calls methods from multiple threads, undefined behavior might result. + + You use this flag if your application will only call methods of Direct3D 11 and Direct3D 10 interfaces from a single thread. By default, Direct3D 11 and Direct3D 10 are thread-safe. + By using this flag, you can increase performance. However, if you use this flag and your application calls methods from multiple threads, undefined behavior might result. + Associate an IUnknown-derived interface with this device child and associate that interface with an application-defined guid. - Microsoft Docs: + + Microsoft Docs: + Guid associated with the interface. Pointer to an IUnknown-derived interface to be associated with the device child. @@ -9483,29 +13132,41 @@ For more info about this array size, see Remarks. Get information about the primitive type, and data order that describes input data for the input assembler stage. - Microsoft Docs: - A pointer to the type of primitive, and ordering of the primitive data (see D3D11_PRIMITIVE_TOPOLOGY). + + Microsoft Docs: + + + A pointer to the type of primitive, and ordering of the primitive data (see D3D11_PRIMITIVE_TOPOLOGY). + A debug interface controls debug settings, validates pipeline state and can only be used if the debug layer is turned on. - Microsoft Docs: + + Microsoft Docs: + Specifies the subresources from an array of cube textures to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + - Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original TextureCube for which ID3D11Device::CreateShaderResourceView creates a view) -1. + + Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original TextureCube for which ID3D11Device::CreateShaderResourceView creates a view) -1. + - The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. + + The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. -Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + Index of the first 2D texture to use. @@ -9516,32 +13177,46 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Returns statistics about the trace. - Microsoft Docs: - A pointer to a D3D11_TRACE_STATS structure. GetTraceStats fills the members of this structure with statistics about the trace. + + Microsoft Docs: + + + A pointer to a D3D11_TRACE_STATS structure. GetTraceStats fills the members of this structure with statistics about the trace. + Contains the response to a D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + The index of the process in the list of processes. - A D3D11_AUTHENTICATED_PROCESS_IDENTIFIER_TYPE value that specifies the type of process. + + A D3D11_AUTHENTICATED_PROCESS_IDENTIFIER_TYPE value that specifies the type of process. + - A process handle. If the ProcessIdentifier member equals D3D11_PROCESSIDTYPE_HANDLE, the ProcessHandle member contains a valid handle to a process. Otherwise, this member is ignored. + + A process handle. If the ProcessIdentifier member equals D3D11_PROCESSIDTYPE_HANDLE, the ProcessHandle member contains a valid handle to a process. Otherwise, this member is ignored. + Contains driver-specific data for the ID3D11VideoContext::DecoderExtension method. - Microsoft Docs: + + Microsoft Docs: + @@ -9551,57 +13226,85 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down A pointer to a buffer that contains input data for the driver. - The size of the pPrivateInputData buffer, in bytes. + + The size of the pPrivateInputData buffer, in bytes. + A pointer to a buffer that the driver can use to write output data. - The size of the pPrivateOutputData buffer, in bytes. + + The size of the pPrivateOutputData buffer, in bytes. + - The number of elements in the ppResourceList array. If ppResourceList is NULL, set ResourceCount to zero. + + The number of elements in the ppResourceList array. If ppResourceList is NULL, set ResourceCount to zero. + - The address of an array of ID3D11Resource pointers. Use this member to pass Direct3D resources to the driver. + + The address of an array of ID3D11Resource pointers. Use this member to pass Direct3D resources to the driver. + Starts a decoding operation to decode a video frame. - Microsoft Docs: - A pointer to the ID3D11VideoDecoder interface. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoder. - A pointer to the ID3D11VideoDecoderOutputView interface. This interface describes the resource that will receive the decoded frame. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoderOutputView. - The size of the content key that is specified in pContentKey. If pContentKey is NULL, set ContentKeySize to zero. - An optional pointer to a content key that was used to encrypt the frame data. If no content key was used, set this parameter to NULL. If the caller provides a content key, the caller must use the session key to encrypt the content key. + + Microsoft Docs: + + + A pointer to the ID3D11VideoDecoder interface. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoder. + + + A pointer to the ID3D11VideoDecoderOutputView interface. This interface describes the resource that will receive the decoded frame. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoderOutputView. + + + The size of the content key that is specified in pContentKey. If pContentKey is NULL, set ContentKeySize to zero. + + + An optional pointer to a content key that was used to encrypt the frame data. If no content key was used, set this parameter to NULL. If the caller provides a content key, the caller must use the session key to encrypt the content key. + Specifies data for initializing a subresource. - Microsoft Docs: + + Microsoft Docs: + Pointer to the initialization data. - The distance (in bytes) from the beginning of one line of a texture to the next line. - System-memory pitch is used only for 2D and 3D texture data as it is has no meaning for the other resource types. Specify the distance from the first pixel of one 2D slice of a 3D texture to the first pixel of the next 2D slice in that texture in the SysMemSlicePitch member. + + The distance (in bytes) from the beginning of one line of a texture to the next line. + System-memory pitch is used only for 2D and 3D texture data as it is has no meaning for the other resource types. Specify the distance from the first pixel of one 2D slice of a 3D texture to the first pixel of the next 2D slice in that texture in the SysMemSlicePitch member. + - The distance (in bytes) from the beginning of one depth level to the next. - System-memory-slice pitch is only used for 3D texture data as it has no meaning for the other resource types. + + The distance (in bytes) from the beginning of one depth level to the next. + System-memory-slice pitch is only used for 3D texture data as it has no meaning for the other resource types. + Get the maximum number of messages that can be added to the message queue. - Microsoft Docs: + + Microsoft Docs: + Specifies the context in which a query occurs. - Microsoft Docs: + + Microsoft Docs: + @@ -9622,11 +13325,15 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Contains input data for a D3D11_AUTHENTICATED_CONFIGURE_ENCRYPTION_WHEN_ACCESSIBLE command. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_CONFIGURE_INPUT structure that contains the command GUID and other data. + + A D3D11_AUTHENTICATED_CONFIGURE_INPUT structure that contains the command GUID and other data. + A GUID that specifies the type of encryption to apply. @@ -9634,7 +13341,9 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Indicates shader type. - Microsoft Docs: + + Microsoft Docs: + @@ -9661,25 +13370,35 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Get an array of sampler state interfaces from the domain-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into a zero-based array to begin getting samplers from (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers to get from a device context. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). + + Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). + Specifies the subresources from an array of 1D textures to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + - Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original Texture1D for which ID3D11Device::CreateShaderResourceView creates a view) -1. + + Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original Texture1D for which ID3D11Device::CreateShaderResourceView creates a view) -1. + - The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. + + The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. -Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + The index of the first texture to use in an array of textures. @@ -9690,41 +13409,60 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Resizes a tile pool. - Microsoft Docs: - A pointer to an ID3D11Buffer for the tile pool to resize. + + Microsoft Docs: + + + A pointer to an ID3D11Buffer for the tile pool to resize. + The new size in bytes of the tile pool. The size must be a multiple of 64 KB or 0. Gets the array of viewports bound to the rasterizer stage. - Microsoft Docs: - A pointer to a variable that, on input, specifies the number of viewports (ranges from 0 to D3D11_VIEWPORT_AND_SCISSORRECT_OBJECT_COUNT_PER_PIPELINE) - in the pViewports array; on output, the variable contains the actual number of viewports that are bound to the rasterizer stage. - If pViewports is NULL, RSGetViewports fills the variable with the number of viewports currently bound. + + Microsoft Docs: + + + A pointer to a variable that, on input, specifies the number of viewports (ranges from 0 to D3D11_VIEWPORT_AND_SCISSORRECT_OBJECT_COUNT_PER_PIPELINE) + in the pViewports array; on output, the variable contains the actual number of viewports that are bound to the rasterizer stage. + If pViewports is NULL, RSGetViewports fills the variable with the number of viewports currently bound. -
Note  In some versions of the Windows SDK, a debug device will raise an exception if the input value in the variable to which pNumViewports points is greater than D3D11_VIEWPORT_AND_SCISSORRECT_OBJECT_COUNT_PER_PIPELINE even if pViewports is NULL. The regular runtime ignores the value in the variable to which pNumViewports points when pViewports is NULL. This behavior of a debug device might be corrected in a future release of the Windows SDK. -
-
 
- An array of D3D11_VIEWPORT structures for the viewports that are bound to the rasterizer stage. If the number of viewports (in the variable to which pNumViewports points) is - greater than the actual number of viewports currently bound, unused elements of the array contain 0. - For info about how the viewport size depends on the device feature level, which has changed between Direct3D 11 - and Direct3D 10, see D3D11_VIEWPORT. +
+ Note  In some versions of the Windows SDK, a debug device will raise an exception if the input value in the variable to which pNumViewports points is greater than D3D11_VIEWPORT_AND_SCISSORRECT_OBJECT_COUNT_PER_PIPELINE even if pViewports is NULL. The regular runtime ignores the value in the variable to which pNumViewports points when pViewports is NULL. This behavior of a debug device might be corrected in a future release of the Windows SDK. +
+
 
+ + + An array of D3D11_VIEWPORT structures for the viewports that are bound to the rasterizer stage. If the number of viewports (in the variable to which pNumViewports points) is + greater than the actual number of viewports currently bound, unused elements of the array contain 0. + For info about how the viewport size depends on the device feature level, which has changed between Direct3D 11 + and Direct3D 10, see D3D11_VIEWPORT. + Get a message from the message queue. - Microsoft Docs: - Index into message queue after an optional retrieval filter has been applied. This can be between 0 and the number of messages in the message queue that pass through the retrieval filter (which can be obtained with ID3D11InfoQueue::GetNumStoredMessagesAllowedByRetrievalFilter). 0 is the message at the front of the message queue. - Returned message (see D3D11_MESSAGE). + + Microsoft Docs: + + + Index into message queue after an optional retrieval filter has been applied. This can be between 0 and the number of messages in the message queue that pass through the retrieval filter (which can be obtained with ID3D11InfoQueue::GetNumStoredMessagesAllowedByRetrievalFilter). 0 is the message at the front of the message queue. + + + Returned message (see D3D11_MESSAGE). + Size of pMessage in bytes, including the size of the message string that the pMessage points to. The stencil operations that can be performed during depth-stencil testing. - Microsoft Docs: + + Microsoft Docs: + @@ -9734,7 +13472,9 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Set the stencil data to 0. - Set the stencil data to the reference value set by calling ID3D11DeviceContext::OMSetDepthStencilState. + + Set the stencil data to the reference value set by calling ID3D11DeviceContext::OMSetDepthStencilState. + Increment the stencil value by 1, and clamp the result. @@ -9754,36 +13494,54 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Provides the video decoding and video processing capabilities of a Microsoft Direct3D 11 device. - Microsoft Docs: + + Microsoft Docs: + Gets a variable by name. - Microsoft Docs: + + Microsoft Docs: + A pointer to a string containing the variable name. Sets a value indicating whether the output surface from a call to ID3D11VideoContext::VideoProcessorBlt will be read by Direct3D shaders. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. - True if the surface rendered using ID3D11VideoContext::VideoProcessorBlt will be read by Direct3D shaders; otherwise, false. This may be set to false when multi-plane overlay hardware is supported. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + + + True if the surface rendered using ID3D11VideoContext::VideoProcessorBlt will be read by Direct3D shaders; otherwise, false. This may be set to false when multi-plane overlay hardware is supported. + A view interface specifies the parts of a resource the pipeline can access during rendering. - Microsoft Docs: + + Microsoft Docs: + Gets a pointer to a decoder buffer. - Microsoft Docs: - A pointer to the ID3D11VideoDecoder interface. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoder. - The type of buffer to retrieve, specified as a member of the D3D11_VIDEO_DECODER_BUFFER_TYPE enumeration. + + Microsoft Docs: + + + A pointer to the ID3D11VideoDecoder interface. To get this pointer, call ID3D11VideoDevice::CreateVideoDecoder. + + + The type of buffer to retrieve, specified as a member of the D3D11_VIDEO_DECODER_BUFFER_TYPE enumeration. + Receives the size of the buffer, in bytes. Receives a pointer to the start of the memory buffer. @@ -9791,27 +13549,43 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Enumerates the video processor capabilities of the driver. - Microsoft Docs: - A pointer to a D3D11_VIDEO_PROCESSOR_CONTENT_DESC structure that describes the video content. - Receives a pointer to the ID3D11VideoProcessorEnumerator interface. The caller must release the interface. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_PROCESSOR_CONTENT_DESC structure that describes the video content. + + + Receives a pointer to the ID3D11VideoProcessorEnumerator interface. The caller must release the interface. + Sets graphics processing unit (GPU) debug reference default tracking options for specific resource types. - Microsoft Docs: - A D3D11_SHADER_TRACKING_RESOURCE_TYPE-typed value that specifies the type of resource to track. - A combination of D3D11_SHADER_TRACKING_OPTIONS-typed flags that are combined by using a bitwise OR operation. The resulting value identifies tracking options. If a flag is present, the tracking option that the flag represents is set to "on"; otherwise the tracking option is set to "off." + + Microsoft Docs: + + + A D3D11_SHADER_TRACKING_RESOURCE_TYPE-typed value that specifies the type of resource to track. + + + A combination of D3D11_SHADER_TRACKING_OPTIONS-typed flags that are combined by using a bitwise OR operation. The resulting value identifies tracking options. If a flag is present, the tracking option that the flag represents is set to "on"; otherwise the tracking option is set to "off." + Contains the response to a D3D11_AUTHENTICATED_QUERY_ENCRYPTION_WHEN_ACCESSIBLE_GUID query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + The index of the encryption GUID. @@ -9822,68 +13596,112 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Add storage filters to the top of the retrieval-filter stack. - Microsoft Docs: - Array of retrieval filters (see D3D11_INFO_QUEUE_FILTER). + + Microsoft Docs: + + + Array of retrieval filters (see D3D11_INFO_QUEUE_FILTER). + Set application-defined data to a device child and associate that data with an application-defined guid. - Microsoft Docs: + + Microsoft Docs: + Guid associated with the data. Size of the data. - Pointer to the data to be stored with this device child. If pData is NULL, DataSize must also be 0, and any data previously associated with the specified guid will be destroyed. + + Pointer to the data to be stored with this device child. If pData is NULL, DataSize must also be 0, and any data previously associated with the specified guid will be destroyed. + Get pointers to the resources bound to the output-merger stage. - Microsoft Docs: + + Microsoft Docs: + The number of render-target views to retrieve. - Pointer to an array of ID3D11RenderTargetViews, which represent render-target views. Specify NULL for this parameter when retrieval of render-target views is not required. - Pointer to a ID3D11DepthStencilView, which represents a depth-stencil view. Specify NULL for this parameter when retrieval of the depth-stencil view is not required. - Index into a zero-based array to begin retrieving unordered-access views (ranges from 0 to D3D11_PS_CS_UAV_REGISTER_COUNT - 1). - For pixel shaders UAVStartSlot should be equal to the number of render-target views that are bound. - Number of unordered-access views to return in ppUnorderedAccessViews. This number ranges from 0 to D3D11_PS_CS_UAV_REGISTER_COUNT - UAVStartSlot. - Pointer to an array of ID3D11UnorderedAccessViews, which represent unordered-access views that are retrieved. Specify NULL for this parameter when retrieval of unordered-access views is not required. + + Pointer to an array of ID3D11RenderTargetViews, which represent render-target views. Specify NULL for this parameter when retrieval of render-target views is not required. + + + Pointer to a ID3D11DepthStencilView, which represents a depth-stencil view. Specify NULL for this parameter when retrieval of the depth-stencil view is not required. + + + Index into a zero-based array to begin retrieving unordered-access views (ranges from 0 to D3D11_PS_CS_UAV_REGISTER_COUNT - 1). + For pixel shaders UAVStartSlot should be equal to the number of render-target views that are bound. + + + Number of unordered-access views to return in ppUnorderedAccessViews. This number ranges from 0 to D3D11_PS_CS_UAV_REGISTER_COUNT - UAVStartSlot. + + + Pointer to an array of ID3D11UnorderedAccessViews, which represent unordered-access views that are retrieved. Specify NULL for this parameter when retrieval of unordered-access views is not required. + The CPU copies data from memory to a subresource created in non-mappable memory. - Microsoft Docs: + + Microsoft Docs: + A pointer to the destination resource. - A zero-based index that identifies the destination subresource. See D3D11CalcSubresource for more details. - A pointer to a box that defines the portion of the destination subresource to copy the resource data into. Coordinates are in bytes for buffers and in texels for textures. If NULL, UpdateSubresource1 writes the data to the destination subresource with no offset. The dimensions of the source must fit the destination. + + A zero-based index that identifies the destination subresource. See D3D11CalcSubresource for more details. + + + A pointer to a box that defines the portion of the destination subresource to copy the resource data into. Coordinates are in bytes for buffers and in texels for textures. If NULL, UpdateSubresource1 writes the data to the destination subresource with no offset. The dimensions of the source must fit the destination. -An empty box results in a no-op. A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. When the box is empty, UpdateSubresource1 doesn't perform an update operation. + An empty box results in a no-op. A box is empty if the top value is greater than or equal to the bottom value, or the left value is greater than or equal to the right value, or the front value is greater than or equal to the back value. When the box is empty, UpdateSubresource1 doesn't perform an update operation. + A pointer to the source data in memory. The size of one row of the source data. The size of one depth slice of source data. - A D3D11_COPY_FLAGS-typed value that specifies how to perform the update operation. If you specify zero for no update option, UpdateSubresource1 behaves like ID3D11DeviceContext::UpdateSubresource. For existing display drivers that can't process these flags, the runtime doesn't use them. + + A D3D11_COPY_FLAGS-typed value that specifies how to perform the update operation. If you specify zero for no update option, UpdateSubresource1 behaves like ID3D11DeviceContext::UpdateSubresource. For existing display drivers that can't process these flags, the runtime doesn't use them. + Gets the current alpha fill mode for the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - Receives the alpha fill mode, as a D3D11_VIDEO_PROCESSOR_ALPHA_FILL_MODE value. - If the alpha fill mode is D3D11_VIDEO_PROCESSOR_ALPHA_FILL_MODE_SOURCE_STREAM, this parameter receives the zero-based index of an input stream. The input stream provides the alpha values for the alpha fill. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + Receives the alpha fill mode, as a D3D11_VIDEO_PROCESSOR_ALPHA_FILL_MODE value. + + + If the alpha fill mode is D3D11_VIDEO_PROCESSOR_ALPHA_FILL_MODE_SOURCE_STREAM, this parameter receives the zero-based index of an input stream. The input stream provides the alpha values for the alpha fill. + Get the properties of the texture resource. - Microsoft Docs: - Pointer to a resource description (see D3D11_TEXTURE2D_DESC). + + Microsoft Docs: + + + Pointer to a resource description (see D3D11_TEXTURE2D_DESC). + Get the number of quality levels available during multisampling. - Microsoft Docs: - The texture format. See DXGI_FORMAT. + + Microsoft Docs: + + + The texture format. See DXGI_FORMAT. + The number of samples during multisampling. Number of quality levels supported by the adapter. See remarks. @@ -9891,136 +13709,214 @@ An empty box results in a no-op. A box is empty if the top value is greater than Gets the driver's certificate chain. - Microsoft Docs: - The size of the pCertificate array, in bytes. To get the size of the certificate chain, call ID3D11CryptoSession::GetCertificateSize. + + Microsoft Docs: + + + The size of the pCertificate array, in bytes. To get the size of the certificate chain, call ID3D11CryptoSession::GetCertificateSize. + A pointer to a byte array that receives the driver's certificate chain. The caller must allocate the array. Retrieves the initial contents of the specified input register. - Microsoft Docs: - A pointer to a D3D11_TRACE_VALUE structure. GetInitialRegisterContents fills the members of this structure with information about the initial contents. + + Microsoft Docs: + + + A pointer to a D3D11_TRACE_VALUE structure. GetInitialRegisterContents fills the members of this structure with information about the initial contents. + Represents the status of an ID3D11CryptoSession interface. - Microsoft Docs: + + Microsoft Docs: + - The ID3D11CryptoSession is in a functional state. + + The ID3D11CryptoSession is in a functional state. + - The underlying hardware key for the specified ID3D11CryptoSession has become lost. + + The underlying hardware key for the specified ID3D11CryptoSession has become lost. + - The underlying hardware key for the specified ID3D11CryptoSession has become lost and protected content has become corrupted. + + The underlying hardware key for the specified ID3D11CryptoSession has become lost and protected content has become corrupted. + Gets a description of the resource. - Microsoft Docs: - A pointer to a D3D11_UNORDERED_ACCESS_VIEW_DESC1 structure that receives the description of the unordered-access resource. + + Microsoft Docs: + + + A pointer to a D3D11_UNORDERED_ACCESS_VIEW_DESC1 structure that receives the description of the unordered-access resource. + Gets the description for blending state that you used to create the blend-state object. - Microsoft Docs: - A pointer to a D3D11_BLEND_DESC1 structure that receives a description of the blend state. This blend state can specify logical operations as well as blending operations. + + Microsoft Docs: + + + A pointer to a D3D11_BLEND_DESC1 structure that receives a description of the blend state. This blend state can specify logical operations as well as blending operations. + The tracking interface sets reference tracking options. - Microsoft Docs: + + Microsoft Docs: + Describes rasterizer state. - Microsoft Docs: + + Microsoft Docs: + - Determines the fill mode to use when rendering (see D3D11_FILL_MODE). + + Determines the fill mode to use when rendering (see D3D11_FILL_MODE). + - Indicates triangles facing the specified direction are not drawn (see D3D11_CULL_MODE). + + Indicates triangles facing the specified direction are not drawn (see D3D11_CULL_MODE). + - Determines if a triangle is front- or back-facing. If this parameter is TRUE, a triangle will be considered front-facing if its vertices are counter-clockwise on the render target and considered back-facing if they are clockwise. If this parameter is FALSE, the opposite is true. + + Determines if a triangle is front- or back-facing. If this parameter is TRUE, a triangle will be considered front-facing if its vertices are counter-clockwise on the render target and considered back-facing if they are clockwise. If this parameter is FALSE, the opposite is true. + - Depth value added to a given pixel. For info about depth bias, see Depth Bias. + + Depth value added to a given pixel. For info about depth bias, see Depth Bias. + - Maximum depth bias of a pixel. For info about depth bias, see Depth Bias. + + Maximum depth bias of a pixel. For info about depth bias, see Depth Bias. + - Scalar on a given pixel's slope. For info about depth bias, see Depth Bias. + + Scalar on a given pixel's slope. For info about depth bias, see Depth Bias. + - Enable clipping based on distance. + + Enable clipping based on distance. -The hardware always performs x and y clipping of rasterized coordinates. When DepthClipEnable is set to the default–TRUE, the hardware also clips the z value (that is, the hardware performs the last step of the following algorithm). + The hardware always performs x and y clipping of rasterized coordinates. When DepthClipEnable is set to the default–TRUE, the hardware also clips the z value (that is, the hardware performs the last step of the following algorithm). -

+      

 0 < w
 -w <= x <= w (or arbitrarily wider range if implementation uses a guard band to reduce clipping burden)
 -w <= y <= w (or arbitrarily wider range if implementation uses a guard band to reduce clipping burden)
 0 <= z <= w
 

-When you set DepthClipEnable to FALSE, the hardware skips the z clipping (that is, the last step in the preceding algorithm). However, the hardware still performs the "0 < w" clipping. When z clipping is disabled, improper depth ordering at the pixel level might result. However, when z clipping is disabled, stencil shadow implementations are simplified. In other words, you can avoid complex special-case handling for geometry that goes beyond the back clipping plane.
 + When you set DepthClipEnable to FALSE, the hardware skips the z clipping (that is, the last step in the preceding algorithm). However, the hardware still performs the "0 < w" clipping. When z clipping is disabled, improper depth ordering at the pixel level might result. However, when z clipping is disabled, stencil shadow implementations are simplified. In other words, you can avoid complex special-case handling for geometry that goes beyond the back clipping plane. + Enable scissor-rectangle culling. All pixels outside an active scissor rectangle are culled. - Specifies whether to use the quadrilateral or alpha line anti-aliasing algorithm on multisample antialiasing (MSAA) render targets. Set to TRUE to use the quadrilateral line anti-aliasing algorithm and to FALSE to use the alpha line anti-aliasing algorithm. For more info about this member, see Remarks. + + Specifies whether to use the quadrilateral or alpha line anti-aliasing algorithm on multisample antialiasing (MSAA) render targets. Set to TRUE to use the quadrilateral line anti-aliasing algorithm and to FALSE to use the alpha line anti-aliasing algorithm. For more info about this member, see Remarks. + - Specifies whether to enable line antialiasing; only applies if doing line drawing and MultisampleEnable is FALSE. For more info about this member, see Remarks. + + Specifies whether to enable line antialiasing; only applies if doing line drawing and MultisampleEnable is FALSE. For more info about this member, see Remarks. + Sets a private IUnknown pointer on the video device and associates that pointer with a GUID. - Microsoft Docs: + + Microsoft Docs: + The GUID associated with the pointer. - A pointer to the IUnknown interface. + + A pointer to the IUnknown interface. + Get the type, name, units of measure, and a description of an existing counter. - Microsoft Docs: - Pointer to a counter description (see D3D11_COUNTER_DESC). Specifies which counter information is to be retrieved about. - Pointer to the data type of a counter (see D3D11_COUNTER_TYPE). Specifies the data type of the counter being retrieved. + + Microsoft Docs: + + + Pointer to a counter description (see D3D11_COUNTER_DESC). Specifies which counter information is to be retrieved about. + + + Pointer to the data type of a counter (see D3D11_COUNTER_TYPE). Specifies the data type of the counter being retrieved. + Pointer to the number of hardware counters that are needed for this counter type to be created. All instances of the same counter type use the same hardware counters. - String to be filled with a brief name for the counter. May be NULL if the application is not interested in the name of the counter. - Length of the string returned to szName. Can be NULL. - Name of the units a counter measures, provided the memory the pointer points to has enough room to hold the string. Can be NULL. The returned string will always be in English. - Length of the string returned to szUnits. Can be NULL. - A description of the counter, provided the memory the pointer points to has enough room to hold the string. Can be NULL. The returned string will always be in English. - Length of the string returned to szDescription. Can be NULL. + + String to be filled with a brief name for the counter. May be NULL if the application is not interested in the name of the counter. + + + Length of the string returned to szName. Can be NULL. + + + Name of the units a counter measures, provided the memory the pointer points to has enough room to hold the string. Can be NULL. The returned string will always be in English. + + + Length of the string returned to szUnits. Can be NULL. + + + A description of the counter, provided the memory the pointer points to has enough room to hold the string. Can be NULL. The returned string will always be in English. + + + Length of the string returned to szDescription. Can be NULL. + Creates a view for accessing an unordered access resource. - Microsoft Docs: - Pointer to an ID3D11Resource that represents a resources that will serve as an input to a shader. - Pointer to an D3D11_UNORDERED_ACCESS_VIEW_DESC that represents a shader-resource view description. Set this parameter to NULL to create a view that accesses the entire resource (using the format the resource was created with). - Address of a pointer to an ID3D11UnorderedAccessView that represents an unordered-access view. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + + Microsoft Docs: + + + Pointer to an ID3D11Resource that represents a resources that will serve as an input to a shader. + + + Pointer to an D3D11_UNORDERED_ACCESS_VIEW_DESC that represents a shader-resource view description. Set this parameter to NULL to create a view that accesses the entire resource (using the format the resource was created with). + + + Address of a pointer to an ID3D11UnorderedAccessView that represents an unordered-access view. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Describes an instance of a hull shader to trace. - Microsoft Docs: + + Microsoft Docs: + @@ -10029,7 +13925,9 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl Determines the fill mode to use when rendering triangles. - Microsoft Docs: + + Microsoft Docs: + @@ -10041,16 +13939,24 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl Set a compute shader to the device. - Microsoft Docs: - Pointer to a compute shader (see ID3D11ComputeShader). Passing in NULL disables the shader for this pipeline stage. - A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + + Microsoft Docs: + + + Pointer to a compute shader (see ID3D11ComputeShader). Passing in NULL disables the shader for this pipeline stage. + + + A pointer to an array of class-instance interfaces (see ID3D11ClassInstance). Each interface used by a shader must have a corresponding class instance or the shader will get disabled. Set ppClassInstances to NULL if the shader does not use any interfaces. + The number of class-instance interfaces in the array. Arguments for draw instanced indirect. - Microsoft Docs: + + Microsoft Docs: + @@ -10068,24 +13974,34 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl Get a constant buffer by name. - Microsoft Docs: + + Microsoft Docs: + The constant-buffer name. Create a vertex-shader object from a compiled shader. - Microsoft Docs: + + Microsoft Docs: + A pointer to the compiled shader. Size of the compiled vertex shader. - A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. - Address of a pointer to a ID3D11VertexShader interface. If this is NULL, all other parameters will be validated, and if all parameters pass validation this API will return S_FALSE instead of S_OK. + + A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. + + + Address of a pointer to a ID3D11VertexShader interface. If this is NULL, all other parameters will be validated, and if all parameters pass validation this API will return S_FALSE instead of S_OK. + Defines a 3D box. - Microsoft Docs: + + Microsoft Docs: + @@ -10109,11 +14025,15 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl Contains input data for a D3D11_AUTHENTICATED_QUERY_RESTRICTED_SHARED_RESOURCE_PROCESS query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_INPUT structure that contains the GUID for the query and other data. + + A D3D11_AUTHENTICATED_QUERY_INPUT structure that contains the GUID for the query and other data. + The index of the process. @@ -10121,23 +14041,37 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl Sets the background color for the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - If TRUE, the color is specified as a YCbCr value. Otherwise, the color is specified as an RGB value. - A pointer to a D3D11_VIDEO_COLOR structure that specifies the background color. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + If TRUE, the color is specified as a YCbCr value. Otherwise, the color is specified as an RGB value. + + + A pointer to a D3D11_VIDEO_COLOR structure that specifies the background color. + Set the rasterizer state for the rasterizer stage of the pipeline. - Microsoft Docs: - Pointer to a rasterizer-state interface (see ID3D11RasterizerState) to bind to the pipeline. + + Microsoft Docs: + + + Pointer to a rasterizer-state interface (see ID3D11RasterizerState) to bind to the pipeline. + Describes an array of unordered-access 1D texture resources. - Microsoft Docs: + + Microsoft Docs: + @@ -10152,16 +14086,24 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl Gets the cryptographic key to decrypt the data returned by the ID3D11VideoContext::EncryptionBlt method. - Microsoft Docs: - A pointer to the ID3D11CryptoSession interface. - The size of the pReadbackKey array, in bytes. The size should match the size of the session key. + + Microsoft Docs: + + + A pointer to the ID3D11CryptoSession interface. + + + The size of the pReadbackKey array, in bytes. The size should match the size of the session key. + A pointer to a byte array that receives the key. The key is encrypted using the session key. Identifies how to perform a tile-mapping operation. - Microsoft Docs: + + Microsoft Docs: + @@ -10170,52 +14112,78 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl A 1D texture interface accesses texel data, which is structured memory. - Microsoft Docs: + + Microsoft Docs: + Gets the properties of the texture resource. - Microsoft Docs: - A pointer to a D3D11_TEXTURE2D_DESC1 structure that receives the description of the 2D texture. + + Microsoft Docs: + + + A pointer to a D3D11_TEXTURE2D_DESC1 structure that receives the description of the 2D texture. + Gets the color space information for the video processor input stream. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + An index identifying the input stream. - A pointer to a DXGI_COLOR_SPACE_TYPE value that specifies the colorspace for the video processor input stream. + + A pointer to a DXGI_COLOR_SPACE_TYPE value that specifies the colorspace for the video processor input stream. + The ID3D11CommandList interface encapsulates a list of graphics commands for play back. - Microsoft Docs: + + Microsoft Docs: + Report information about a device object's lifetime. - Microsoft Docs: - A value from the - D3D11_RLDO_FLAGS enumeration. + + Microsoft Docs: + + + A value from the + D3D11_RLDO_FLAGS enumeration. + Get pointers to the resources bound to the output-merger stage. - Microsoft Docs: + + Microsoft Docs: + Number of render targets to retrieve. - Pointer to an array of ID3D11RenderTargetViews which represent render target views. Specify NULL for this parameter when retrieval of a render target is not needed. - Pointer to a ID3D11DepthStencilView, which represents a depth-stencil view. Specify NULL for this parameter when retrieval of the depth-stencil view is not needed. + + Pointer to an array of ID3D11RenderTargetViews which represent render target views. Specify NULL for this parameter when retrieval of a render target is not needed. + + + Pointer to a ID3D11DepthStencilView, which represents a depth-stencil view. Specify NULL for this parameter when retrieval of the depth-stencil view is not needed. + Specifies the subresources from an array of 2D textures to use in a render-target view. - Microsoft Docs: + + Microsoft Docs: + @@ -10225,12 +14193,16 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl The index of the first texture to use in an array of textures. - Number of textures in the array to use in the render target view, starting from FirstArraySlice. + + Number of textures in the array to use in the render target view, starting from FirstArraySlice. + Specifies an RGB color value. - Microsoft Docs: + + Microsoft Docs: + @@ -10248,71 +14220,95 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl Create a sampler-state object that encapsulates sampling information for a texture. - Microsoft Docs: - Pointer to a sampler state description (see D3D11_SAMPLER_DESC). - Address of a pointer to the sampler state object created (see ID3D11SamplerState). + + Microsoft Docs: + + + Pointer to a sampler state description (see D3D11_SAMPLER_DESC). + + + Address of a pointer to the sampler state object created (see ID3D11SamplerState). + Specifies the layout in memory of a stereo 3D video frame. - Microsoft Docs: + + Microsoft Docs: + The sample does not contain stereo data. If the stereo format is not specified, this value is the default. - Frame 0 and frame 1 are packed side-by-side, as shown in the following diagram. + + Frame 0 and frame 1 are packed side-by-side, as shown in the following diagram. -Side-by-side packing + Side-by-side packing -All drivers that support stereo video must support this format. + All drivers that support stereo video must support this format. + - Frame 0 and frame 1 are packed top-to-bottom, as shown in the following diagram. + + Frame 0 and frame 1 are packed top-to-bottom, as shown in the following diagram. -Top-to-bottom packing + Top-to-bottom packing -All drivers that support stereo video must support this format. + All drivers that support stereo video must support this format. + - Frame 0 and frame 1 are placed in separate resources or in separate texture array elements within the same resource. + + Frame 0 and frame 1 are placed in separate resources or in separate texture array elements within the same resource. -All drivers that support stereo video must support this format. + All drivers that support stereo video must support this format. + - The sample contains non-stereo data. However, the driver should create a left/right output of this sample using a specified offset. The offset is specified in the MonoOffset parameter of the ID3D11VideoContext::VideoProcessorSetStreamStereoFormat method. + + The sample contains non-stereo data. However, the driver should create a left/right output of this sample using a specified offset. The offset is specified in the MonoOffset parameter of the ID3D11VideoContext::VideoProcessorSetStreamStereoFormat method. -This format is primarily intended for subtitles and other subpicture data, where the entire sample is presented on the same plane. + This format is primarily intended for subtitles and other subpicture data, where the entire sample is presented on the same plane. -Support for this stereo format is optional. + Support for this stereo format is optional. + - Frame 0 and frame 1 are packed into interleaved rows, as shown in the following diagram. + + Frame 0 and frame 1 are packed into interleaved rows, as shown in the following diagram. -Interleaved rows + Interleaved rows -Support for this stereo format is optional. + Support for this stereo format is optional. + - Frame 0 and frame 1 are packed into interleaved columns, as shown in the following diagram. + + Frame 0 and frame 1 are packed into interleaved columns, as shown in the following diagram. -Interleaved columns + Interleaved columns -Support for this stereo format is optional. + Support for this stereo format is optional. + - Frame 0 and frame 1 are packed in a checkerboard format, as shown in the following diagram. + + Frame 0 and frame 1 are packed in a checkerboard format, as shown in the following diagram. -Checkerboard packing + Checkerboard packing -Support for this stereo format is optional. + Support for this stereo format is optional. + Give a device access to a shared resource created on a different device. - Microsoft Docs: + + Microsoft Docs: + A resource handle. See remarks. The globally unique identifier (GUID) for the resource interface. See remarks. Address of a pointer to the resource we are gaining access to. @@ -10321,11 +14317,15 @@ Support for this stereo format is optional. Contains input data for a D3D11_AUTHENTICATED_QUERY_CRYPTO_SESSION query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_INPUT structure that contains the GUID for the query and other data. + + A D3D11_AUTHENTICATED_QUERY_INPUT structure that contains the GUID for the query and other data. + A handle to a decoder device. @@ -10333,11 +14333,15 @@ Support for this stereo format is optional. Describes a video stream for a Microsoft Direct3D 11 video decoder or video processor. - Microsoft Docs: + + Microsoft Docs: + - The decoding profile. To get the list of profiles supported by the device, call the ID3D11VideoDevice::GetVideoDecoderProfile method. + + The decoding profile. To get the list of profiles supported by the device, call the ID3D11VideoDevice::GetVideoDecoderProfile method. + The width of the video frame, in pixels. @@ -10346,21 +14350,33 @@ Support for this stereo format is optional. The height of the video frame, in pixels. - The output surface format, specified as a DXGI_FORMAT value. + + The output surface format, specified as a DXGI_FORMAT value. + Creates a shader-trace interface for a shader-trace information object. - Microsoft Docs: - A pointer to the interface of the shader to create the shader-trace interface for. For example, pShader can be an instance of ID3D11VertexShader, ID3D11PixelShader, and so on. - A pointer to a D3D11_SHADER_TRACE_DESC structure that describes the shader-trace object to create. This parameter cannot be NULL. - A pointer to a variable that receives a pointer to the ID3D11ShaderTrace interface for the shader-trace object that CreateShaderTrace creates. + + Microsoft Docs: + + + A pointer to the interface of the shader to create the shader-trace interface for. For example, pShader can be an instance of ID3D11VertexShader, ID3D11PixelShader, and so on. + + + A pointer to a D3D11_SHADER_TRACE_DESC structure that describes the shader-trace object to create. This parameter cannot be NULL. + + + A pointer to a variable that receives a pointer to the ID3D11ShaderTrace interface for the shader-trace object that CreateShaderTrace creates. + Describes the level of support for shader caching in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + @@ -10375,18 +14391,30 @@ Support for this stereo format is optional. Sets the luma key for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + Specifies whether luma keying is enabled. - The lower bound for the luma key. The valid range is [0…1]. If Enable is FALSE, this parameter is ignored. - The upper bound for the luma key. The valid range is [0…1]. If Enable is FALSE, this parameter is ignored. + + The lower bound for the luma key. The valid range is [0…1]. If Enable is FALSE, this parameter is ignored. + + + The upper bound for the luma key. The valid range is [0…1]. If Enable is FALSE, this parameter is ignored. + Describes the subresources from an array of 2D textures to use in a render-target view. - Microsoft Docs: + + Microsoft Docs: + @@ -10396,7 +14424,9 @@ Support for this stereo format is optional. The index of the first texture to use in an array of textures. - Number of textures in the array to use in the render-target view, starting from FirstArraySlice. + + Number of textures in the array to use in the render-target view, starting from FirstArraySlice. + The index (plane slice number) of the plane to use in an array of textures. @@ -10404,7 +14434,9 @@ Support for this stereo format is optional. Describes the level of shader caching supported in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + @@ -10413,121 +14445,191 @@ Support for this stereo format is optional. Gets info about how a tiled resource is broken into tiles. - Microsoft Docs: + + Microsoft Docs: + A pointer to the tiled resource to get info about. A pointer to a variable that receives the number of tiles needed to store the entire tiled resource. - A pointer to a D3D11_PACKED_MIP_DESC structure that GetResourceTiling fills with info about how the tiled resource's mipmaps are packed. - A pointer to a D3D11_TILE_SHAPE structure that GetResourceTiling fills with info about the tile shape. This is info about how pixels fit in the tiles, independent of tiled resource's dimensions, - not including packed mipmaps. If the entire tiled resource is packed, this parameter is meaningless because the tiled resource has no defined layout - for packed mipmaps. - In this situation, GetResourceTiling sets the members of D3D11_TILE_SHAPE to zeros. - A pointer to a variable that contains the number of tiles in the subresource. On input, this is the number of subresources to query tilings for; on output, this is the number that was actually retrieved at pSubresourceTilingsForNonPackedMips (clamped to what's available). - The number of the first subresource tile to get. GetResourceTiling ignores this parameter if the number that pNumSubresourceTilings points to is 0. - A pointer to a D3D11_SUBRESOURCE_TILING structure that GetResourceTiling fills with info about subresource tiles. - + + A pointer to a D3D11_PACKED_MIP_DESC structure that GetResourceTiling fills with info about how the tiled resource's mipmaps are packed. + + + A pointer to a D3D11_TILE_SHAPE structure that GetResourceTiling fills with info about the tile shape. This is info about how pixels fit in the tiles, independent of tiled resource's dimensions, + not including packed mipmaps. If the entire tiled resource is packed, this parameter is meaningless because the tiled resource has no defined layout + for packed mipmaps. + In this situation, GetResourceTiling sets the members of D3D11_TILE_SHAPE to zeros. + + + A pointer to a variable that contains the number of tiles in the subresource. On input, this is the number of subresources to query tilings for; on output, this is the number that was actually retrieved at pSubresourceTilingsForNonPackedMips (clamped to what's available). + + + The number of the first subresource tile to get. GetResourceTiling ignores this parameter if the number that pNumSubresourceTilings points to is 0. + + + A pointer to a D3D11_SUBRESOURCE_TILING structure that GetResourceTiling fills with info about subresource tiles. -If subresource tiles are part of packed mipmaps, GetResourceTiling sets the members of D3D11_SUBRESOURCE_TILING to zeros, except the StartTileIndexInOverallResource member, which GetResourceTiling sets to D3D11_PACKED_TILE (0xffffffff). The D3D11_PACKED_TILE constant indicates that the whole - D3D11_SUBRESOURCE_TILING structure is meaningless for this situation, and the info that the pPackedMipDesc parameter points to applies. + + If subresource tiles are part of packed mipmaps, GetResourceTiling sets the members of D3D11_SUBRESOURCE_TILING to zeros, except the StartTileIndexInOverallResource member, which GetResourceTiling sets to D3D11_PACKED_TILE (0xffffffff). The D3D11_PACKED_TILE constant indicates that the whole + D3D11_SUBRESOURCE_TILING structure is meaningless for this situation, and the info that the pPackedMipDesc parameter points to applies. + Creates a buffer (vertex buffer, index buffer, or shader-constant buffer). - Microsoft Docs: - A pointer to a D3D11_BUFFER_DESC structure that describes the buffer. - A pointer to a D3D11_SUBRESOURCE_DATA structure that describes the initialization data; - use NULL to allocate space only (with the exception that it cannot be NULL if the usage flag is D3D11_USAGE_IMMUTABLE). - + + Microsoft Docs: + + + A pointer to a D3D11_BUFFER_DESC structure that describes the buffer. + + + A pointer to a D3D11_SUBRESOURCE_DATA structure that describes the initialization data; + use NULL to allocate space only (with the exception that it cannot be NULL if the usage flag is D3D11_USAGE_IMMUTABLE). -If you don't pass anything to pInitialData, the initial content of the memory for the buffer is undefined. - In this case, you need to write the buffer content some other way before the resource is read. - Address of a pointer to the ID3D11Buffer interface for the buffer object created. - Set this parameter to NULL to validate the other input parameters (S_FALSE indicates a pass). + + If you don't pass anything to pInitialData, the initial content of the memory for the buffer is undefined. + In this case, you need to write the buffer content some other way before the resource is read. + + + Address of a pointer to the ID3D11Buffer interface for the buffer object created. + Set this parameter to NULL to validate the other input parameters (S_FALSE indicates a pass). + The device interface represents a virtual adapter; it is used to create resources. ID3D11Device4 adds new methods to those in ID3D11Device3, such as RegisterDeviceRemovedEvent and UnregisterDeviceRemoved. - Microsoft Docs: + + Microsoft Docs: + Specifies the subresources of a texture that are accessible from a depth-stencil view. - Microsoft Docs: + + Microsoft Docs: + - Resource data format (see DXGI_FORMAT). See remarks for allowable formats. + + Resource data format (see DXGI_FORMAT). See remarks for allowable formats. + - Type of resource (see D3D11_DSV_DIMENSION). Specifies how a depth-stencil resource will be accessed; the value is stored in the - union in this structure. + + Type of resource (see D3D11_DSV_DIMENSION). Specifies how a depth-stencil resource will be accessed; the value is stored in the + union in this structure. + - A value that describes whether the texture is read only. Pass 0 to specify that it is not read only; otherwise, pass one of the members of - the D3D11_DSV_FLAG enumerated type. + + A value that describes whether the texture is read only. Pass 0 to specify that it is not read only; otherwise, pass one of the members of + the D3D11_DSV_FLAG enumerated type. + - Specifies a 1D texture subresource (see D3D11_TEX1D_DSV). + + Specifies a 1D texture subresource (see D3D11_TEX1D_DSV). + - Specifies an array of 1D texture subresources (see D3D11_TEX1D_ARRAY_DSV). + + Specifies an array of 1D texture subresources (see D3D11_TEX1D_ARRAY_DSV). + - Specifies a 2D texture subresource (see D3D11_TEX2D_DSV). + + Specifies a 2D texture subresource (see D3D11_TEX2D_DSV). + - Specifies an array of 2D texture subresources (see D3D11_TEX2D_ARRAY_DSV). + + Specifies an array of 2D texture subresources (see D3D11_TEX2D_ARRAY_DSV). + - Specifies a multisampled 2D texture (see D3D11_TEX2DMS_DSV). + + Specifies a multisampled 2D texture (see D3D11_TEX2DMS_DSV). + - Specifies an array of multisampled 2D textures (see D3D11_TEX2DMS_ARRAY_DSV). + + Specifies an array of multisampled 2D textures (see D3D11_TEX2DMS_ARRAY_DSV). + Clears an unordered access resource with a float value. - Microsoft Docs: - The ID3D11UnorderedAccessView to clear. + + Microsoft Docs: + + + The ID3D11UnorderedAccessView to clear. + Values to copy to corresponding channels, see remarks. Get the vertex shader resources. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin getting shader resources from (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). The number of resources to get from the device. Up to a maximum of 128 slots are available for shader resources (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to be returned by the device. + + Array of shader resource view interfaces to be returned by the device. + Gets the constant buffers that the compute-shader stage uses. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + Array of constant buffer interface pointers to be returned by the method. - A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. - A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + + A pointer to an array that receives the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 2 indicates that the start of the associated constant buffer is 32 bytes into the constant buffer. The runtime sets pFirstConstant to NULL if the buffers do not have offsets. + + + A pointer to an array that receives the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. The runtime sets pNumConstants to NULL if it doesn't specify the numbers of constants in each buffer. + Gets the color-palette entries for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - The number of entries in the pEntries array. - A pointer to a UINT array allocated by the caller. The method fills the array with the palette entries. For RGB streams, the palette entries use the DXGI_FORMAT_B8G8R8A8 representation. For YCbCr streams, the palette entries use the DXGI_FORMAT_AYUV representation. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + The number of entries in the pEntries array. + + + A pointer to a UINT array allocated by the caller. The method fills the array with the palette entries. For RGB streams, the palette entries use the DXGI_FORMAT_B8G8R8A8 representation. For YCbCr streams, the palette entries use the DXGI_FORMAT_AYUV representation. + Specifies the type of sampler filter reduction. - Microsoft Docs: + + Microsoft Docs: + @@ -10545,7 +14647,9 @@ If you don't pass anything to pInitialData, the initial content of the me Specifies the subresources from a 3D texture to use in a render-target view. - Microsoft Docs: + + Microsoft Docs: + @@ -10555,12 +14659,16 @@ If you don't pass anything to pInitialData, the initial content of the me First depth level to use. - Number of depth levels to use in the render-target view, starting from FirstWSlice. A value of -1 indicates all of the slices along the w axis, starting from FirstWSlice. + + Number of depth levels to use in the render-target view, starting from FirstWSlice. A value of -1 indicates all of the slices along the w axis, starting from FirstWSlice. + Rebinds a sampler from source slot to destination slot. - Microsoft Docs: + + Microsoft Docs: + The first source slot number for rebinding. The first destination slot number for rebinding. The number of slots for rebinding. @@ -10569,49 +14677,59 @@ If you don't pass anything to pInitialData, the initial content of the me Creates a shared handle to a fence object. - Microsoft Docs: - A pointer to a SECURITY_ATTRIBUTESstructure that contains two separate but related data members: an optional security descriptor, and a Booleanvalue that determines whether child processes can inherit the returned handle. - + + Microsoft Docs: + + + A pointer to a SECURITY_ATTRIBUTESstructure that contains two separate but related data members: an optional security descriptor, and a Booleanvalue that determines whether child processes can inherit the returned handle. -Set this parameter to NULL if you want child processes that the - application might create to not inherit the handle returned by - CreateSharedHandle, and if you want the resource that is associated with the returned handle to get a default security - descriptor. - -The lpSecurityDescriptor member of the structure specifies a - SECURITY_DESCRIPTOR for the resource. - Set this member to NULL if you want the runtime to assign a default security descriptor to the resource that is associated with the returned handle. - The ACLs in the default security descriptor for the resource come from the primary or impersonation token of the creator. - For more info, see Synchronization Object Security and Access Rights. + Set this parameter to NULL if you want child processes that the + application might create to not inherit the handle returned by + CreateSharedHandle, and if you want the resource that is associated with the returned handle to get a default security + descriptor. + + + The lpSecurityDescriptor member of the structure specifies a + SECURITY_DESCRIPTOR for the resource. + Set this member to NULL if you want the runtime to assign a default security descriptor to the resource that is associated with the returned handle. + The ACLs in the default security descriptor for the resource come from the primary or impersonation token of the creator. + For more info, see Synchronization Object Security and Access Rights. + Currently the only value this parameter accepts is GENERIC_ALL. - A NULL-terminated UNICODE string that contains the name to associate with the shared heap. - The name is limited to MAX_PATH characters. - Name comparison is case-sensitive. - + + A NULL-terminated UNICODE string that contains the name to associate with the shared heap. + The name is limited to MAX_PATH characters. + Name comparison is case-sensitive. -If Name matches the name of an existing resource, CreateSharedHandle fails with DXGI_ERROR_NAME_ALREADY_EXISTS. - This occurs because these objects share the same namespace. - -The name can have a "Global\" or "Local\" prefix to explicitly create the object in the global or session namespace. - The remainder of the name can contain any character except the backslash character (\\). - For more information, see - Kernel Object Namespaces. - Fast user switching is implemented using Terminal Services sessions. - Kernel object names must follow the guidelines outlined for Terminal Services so that applications can support multiple users. - + If Name matches the name of an existing resource, CreateSharedHandle fails with DXGI_ERROR_NAME_ALREADY_EXISTS. + This occurs because these objects share the same namespace. -The object can be created in a private namespace. - For more information, see Object Namespaces. - A pointer to a variable that receives the NT HANDLE value to the resource to share. - You can use this handle in calls to access the resource. + + The name can have a "Global\" or "Local\" prefix to explicitly create the object in the global or session namespace. + The remainder of the name can contain any character except the backslash character (\\). + For more information, see + Kernel Object Namespaces. + Fast user switching is implemented using Terminal Services sessions. + Kernel object names must follow the guidelines outlined for Terminal Services so that applications can support multiple users. + + + The object can be created in a private namespace. + For more information, see Object Namespaces. + + + A pointer to a variable that receives the NT HANDLE value to the resource to share. + You can use this handle in calls to access the resource. + Query information about the amount of data streamed out to the stream-output buffers in between ID3D11DeviceContext::Begin and ID3D11DeviceContext::End. - Microsoft Docs: + + Microsoft Docs: + @@ -10623,27 +14741,39 @@ The object can be created in a private namespace. Describes the blend state that you use in a call to ID3D11Device::CreateBlendState to create a blend-state object. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether to use alpha-to-coverage as a multisampling technique when setting a pixel to a render target. For more info about using alpha-to-coverage, see Alpha-To-Coverage. + + Specifies whether to use alpha-to-coverage as a multisampling technique when setting a pixel to a render target. For more info about using alpha-to-coverage, see Alpha-To-Coverage. + - Specifies whether to enable independent blending in simultaneous render targets. Set to TRUE to enable independent blending. If set to FALSE, only the RenderTarget[0] members are used; RenderTarget[1..7] are ignored. + + Specifies whether to enable independent blending in simultaneous render targets. Set to TRUE to enable independent blending. If set to FALSE, only the RenderTarget[0] members are used; RenderTarget[1..7] are ignored. + - An array of D3D11_RENDER_TARGET_BLEND_DESC structures that describe the blend states for render targets; these correspond to the eight render targets - that can be bound to the output-merger stage at one time. + + An array of D3D11_RENDER_TARGET_BLEND_DESC structures that describe the blend states for render targets; these correspond to the eight render targets + that can be bound to the output-merger stage at one time. + Contains the response to a D3D11_AUTHENTICATED_QUERY_CRYPTO_SESSION query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + + A D3D11_AUTHENTICATED_QUERY_OUTPUT structure that contains a Message Authentication Code (MAC) and other data. + A handle to a decoder device. @@ -10657,14 +14787,20 @@ The object can be created in a private namespace. Describes a sampler state. - Microsoft Docs: + + Microsoft Docs: + - Filtering method to use when sampling a texture (see D3D11_FILTER). + + Filtering method to use when sampling a texture (see D3D11_FILTER). + - Method to use for resolving a u texture coordinate that is outside the 0 to 1 range (see D3D11_TEXTURE_ADDRESS_MODE). + + Method to use for resolving a u texture coordinate that is outside the 0 to 1 range (see D3D11_TEXTURE_ADDRESS_MODE). + Method to use for resolving a v texture coordinate that is outside the 0 to 1 range. @@ -10679,7 +14815,9 @@ The object can be created in a private namespace. Clamping value used if D3D11_FILTER_ANISOTROPIC or D3D11_FILTER_COMPARISON_ANISOTROPIC is specified in Filter. Valid values are between 1 and 16. - A function that compares sampled data against existing sampled data. The function options are listed in D3D11_COMPARISON_FUNC. + + A function that compares sampled data against existing sampled data. The function options are listed in D3D11_COMPARISON_FUNC. + Border color to use if D3D11_TEXTURE_ADDRESS_BORDER is specified for AddressU, AddressV, or AddressW. Range must be between 0.0 and 1.0 inclusive. @@ -10693,19 +14831,25 @@ The object can be created in a private namespace. Leave a device's critical section. - Microsoft Docs: + + Microsoft Docs: + Contains stream-level data for the ID3D11VideoContext::VideoProcessorBlt method. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether this input stream is enabled. If the value is TRUE, the VideoProcessorBlt method blits this stream to the output surface. Otherwise, this stream is not blitted. + + Specifies whether this input stream is enabled. If the value is TRUE, the VideoProcessorBlt method blits this stream to the output surface. Otherwise, this stream is not blitted. -The maximum number of streams that can be enabled at one time is given in the MaxInputStreams member of the D3D11_VIDEO_PROCESSOR_CAPS structure. + The maximum number of streams that can be enabled at one time is given in the MaxInputStreams member of the D3D11_VIDEO_PROCESSOR_CAPS structure. + The zero-based index number of the output frame. @@ -10720,104 +14864,171 @@ The maximum number of streams that can be enabled at one time is given in the The number of future reference frames. - A pointer to an array of ID3D11VideoProcessorInputView pointers, allocated by the caller. This array contains the past reference frames for the video processing operation. The number of elements in the array is equal to PastFrames. + + A pointer to an array of ID3D11VideoProcessorInputView pointers, allocated by the caller. This array contains the past reference frames for the video processing operation. The number of elements in the array is equal to PastFrames. + - A pointer to the ID3D11VideoProcessorInputView interface of the surface that contains the current input frame. + + A pointer to the ID3D11VideoProcessorInputView interface of the surface that contains the current input frame. + - A pointer to an array of ID3D11VideoProcessorInputView pointers, allocated by the caller. This array contains the future reference frames for the video processing operation. The number of elements in the array is equal to FutureFrames. + + A pointer to an array of ID3D11VideoProcessorInputView pointers, allocated by the caller. This array contains the future reference frames for the video processing operation. The number of elements in the array is equal to FutureFrames. + - If the stereo 3D format is D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE, this member points to an array that contains the past reference frames for the right view. The number of elements in the array is equal to PastFrames. + + If the stereo 3D format is D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE, this member points to an array that contains the past reference frames for the right view. The number of elements in the array is equal to PastFrames. -For any other stereo 3D format, set this member to NULL. For more information, see ID3D11VideoContext::VideoProcessorSetStreamStereoFormat. + For any other stereo 3D format, set this member to NULL. For more information, see ID3D11VideoContext::VideoProcessorSetStreamStereoFormat. + - If the stereo 3D format is D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE, this member contains a pointer to the current input frame for the right view. + + If the stereo 3D format is D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE, this member contains a pointer to the current input frame for the right view. -For any other stereo 3D format, set this member to NULL. + For any other stereo 3D format, set this member to NULL. + - If the stereo 3D format is D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE, this member points to an array that contains the future reference frames for the right view. The number of elements in the array is equal to FutureFrames. + + If the stereo 3D format is D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE, this member points to an array that contains the future reference frames for the right view. The number of elements in the array is equal to FutureFrames. -For any other stereo 3D format, set this member to NULL. + For any other stereo 3D format, set this member to NULL. + Gets the decoding profile of the session. - Microsoft Docs: - Receives the decoding profile. For a list of possible values, see ID3D11VideoDevice::GetVideoDecoderProfile. + + Microsoft Docs: + + + Receives the decoding profile. For a list of possible values, see ID3D11VideoDevice::GetVideoDecoderProfile. + Get the properties of a render target view. - Microsoft Docs: - Pointer to the description of a render target view (see D3D11_RENDER_TARGET_VIEW_DESC). + + Microsoft Docs: + + + Pointer to the description of a render target view (see D3D11_RENDER_TARGET_VIEW_DESC). + Enables or disables stereo 3D video for an input stream on the video processor. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. - Specifies whether stereo 3D is enabled for this stream. If the value is FALSE, the remaining parameters of this method are ignored. - Specifies the layout of the two stereo views in memory, as a D3D11_VIDEO_PROCESSOR_STEREO_FORMAT value. - If TRUE, frame 0 contains the left view. Otherwise, frame 0 contains the right view. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + The zero-based index of the input stream. To get the maximum number of streams, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the MaxStreamStates structure member. + + + Specifies whether stereo 3D is enabled for this stream. If the value is FALSE, the remaining parameters of this method are ignored. + + + Specifies the layout of the two stereo views in memory, as a D3D11_VIDEO_PROCESSOR_STEREO_FORMAT value. + + + If TRUE, frame 0 contains the left view. Otherwise, frame 0 contains the right view. -This parameter is ignored for the following stereo formats: + This parameter is ignored for the following stereo formats: -
    -
  • D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO
    • -
  • D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET
    • -
- If TRUE, frame 0 contains the base view. Otherwise, frame 1 contains the base view. +
    +
  • + D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO +
    • +
  • + D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET +
    • +
+ + + If TRUE, frame 0 contains the base view. Otherwise, frame 1 contains the base view. -This parameter is ignored for the following stereo formats: + This parameter is ignored for the following stereo formats: -
    -
  • D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO
    • -
  • D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET
    • -
  • When D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE is used and the application wants to convert the stereo data to mono, it can either:
      -
    • Specify the base view as a mono input.
      • -
    • Specify both resources and allow the driver to do the conversion from the base view. In this case, D3D11_VIDEO_PROCESSOR_STREAM.hInputSurface is considered frame 0 and D3D11_VIDEO_PROCESSOR_STREAM.hInputSurfaceRight is considered frame 1.
      • -
    -
    • -
- A flag from the D3D11_VIDEO_PROCESSOR_STEREO_FLIP_MODE enumeration, specifying whether one of the views is flipped. - For D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET format, this parameter specifies how to generate the left and right views: +
    +
  • + D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO +
    • +
  • + D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET +
    • +
  • + When D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_SEPARATE is used and the application wants to convert the stereo data to mono, it can either:
      +
    • Specify the base view as a mono input.
      • +
    • + Specify both resources and allow the driver to do the conversion from the base view. In this case, D3D11_VIDEO_PROCESSOR_STREAM.hInputSurface is considered frame 0 and D3D11_VIDEO_PROCESSOR_STREAM.hInputSurfaceRight is considered frame 1. +
      • +
    +
    • +
+ + + A flag from the D3D11_VIDEO_PROCESSOR_STEREO_FLIP_MODE enumeration, specifying whether one of the views is flipped. + + + For D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET format, this parameter specifies how to generate the left and right views: -
    -
  • If MonoOffset is positive, the right view is shifted to the right by that many pixels, and the left view is shifted to the left by the same amount.
    • -
  • If MonoOffset is negative, the right view is shifted to the left by that many pixels, and the left view is shifted to right by the same amount.
    • -
-If Format is not D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET, this parameter must be zero. +
    +
  • + If MonoOffset is positive, the right view is shifted to the right by that many pixels, and the left view is shifted to the left by the same amount. +
    • +
  • + If MonoOffset is negative, the right view is shifted to the left by that many pixels, and the left view is shifted to right by the same amount. +
    • +
+ If Format is not D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET, this parameter must be zero. + Sets the color space information for the video processor input stream. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. + An index identifying the input stream. - A DXGI_COLOR_SPACE_TYPE value that specifies the colorspace for the video processor input stream. + + A DXGI_COLOR_SPACE_TYPE value that specifies the colorspace for the video processor input stream. + Get the hull shader currently set on the device. - Microsoft Docs: - Address of a pointer to a hull shader (see ID3D11HullShader) to be returned by the method. - Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + + Microsoft Docs: + + + Address of a pointer to a hull shader (see ID3D11HullShader) to be returned by the method. + + + Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + The number of class-instance elements in the array. Specifies the parts of the depth stencil to clear. - Microsoft Docs: + + Microsoft Docs: + @@ -10829,74 +15040,114 @@ If Format is not D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET, Create an input-layout object to describe the input-buffer data for the input-assembler stage. - Microsoft Docs: - An array of the input-assembler stage input data types; each type is described by an element description (see D3D11_INPUT_ELEMENT_DESC). + + Microsoft Docs: + + + An array of the input-assembler stage input data types; each type is described by an element description (see D3D11_INPUT_ELEMENT_DESC). + The number of input-data types in the array of input-elements. A pointer to the compiled shader. The compiled shader code contains a input signature which is validated against the array of elements. See remarks. Size of the compiled shader. - A pointer to the input-layout object created (see ID3D11InputLayout). To validate the other input parameters, set this pointer to be NULL and verify that the method returns S_FALSE. + + A pointer to the input-layout object created (see ID3D11InputLayout). To validate the other input parameters, set this pointer to be NULL and verify that the method returns S_FALSE. + Creates a device that represents the display adapter. - Microsoft Docs: - A pointer to the video adapter to use when creating a device. Pass NULL to use the default adapter, which is the first adapter that is enumerated by IDXGIFactory1::EnumAdapters. + + Microsoft Docs: + + + A pointer to the video adapter to use when creating a device. Pass NULL to use the default adapter, which is the first adapter that is enumerated by IDXGIFactory1::EnumAdapters. -
Note  Do not mix the use of DXGI 1.0 (IDXGIFactory) and DXGI 1.1 (IDXGIFactory1) in an application. Use IDXGIFactory or IDXGIFactory1, but not both in an application. -
-
 
- The D3D_DRIVER_TYPE, which represents the driver type to create. - A handle to a DLL that implements a software rasterizer. - If DriverType is D3D_DRIVER_TYPE_SOFTWARE, - Software must not be NULL. Get the handle by - calling LoadLibrary, - LoadLibraryEx , - or GetModuleHandle. - The runtime layers to enable (see D3D11_CREATE_DEVICE_FLAG); - values can be bitwise OR'd together. - A pointer to an array of D3D_FEATURE_LEVELs, which determine the order of feature levels to attempt to create. - If pFeatureLevels is set to NULL, - this function uses the following array of feature levels: - +
+ Note  Do not mix the use of DXGI 1.0 (IDXGIFactory) and DXGI 1.1 (IDXGIFactory1) in an application. Use IDXGIFactory or IDXGIFactory1, but not both in an application. +
+
 
+ + + The D3D_DRIVER_TYPE, which represents the driver type to create. + + + A handle to a DLL that implements a software rasterizer. + If DriverType is D3D_DRIVER_TYPE_SOFTWARE, + Software must not be NULL. Get the handle by + calling LoadLibrary, + LoadLibraryEx , + or GetModuleHandle. + + + The runtime layers to enable (see D3D11_CREATE_DEVICE_FLAG); + values can be bitwise OR'd together. + + + A pointer to an array of D3D_FEATURE_LEVELs, which determine the order of feature levels to attempt to create. + If pFeatureLevels is set to NULL, + this function uses the following array of feature levels: - -{ - D3D_FEATURE_LEVEL_11_0, - D3D_FEATURE_LEVEL_10_1, - D3D_FEATURE_LEVEL_10_0, - D3D_FEATURE_LEVEL_9_3, - D3D_FEATURE_LEVEL_9_2, - D3D_FEATURE_LEVEL_9_1, -}; - + + + { + D3D_FEATURE_LEVEL_11_0, + D3D_FEATURE_LEVEL_10_1, + D3D_FEATURE_LEVEL_10_0, + D3D_FEATURE_LEVEL_9_3, + D3D_FEATURE_LEVEL_9_2, + D3D_FEATURE_LEVEL_9_1, + }; + -
Note  If the Direct3D 11.1 runtime is present on the computer and pFeatureLevels is set to NULL, this function won't create a D3D_FEATURE_LEVEL_11_1 device. To create a D3D_FEATURE_LEVEL_11_1 device, you must explicitly provide a D3D_FEATURE_LEVEL array that includes D3D_FEATURE_LEVEL_11_1. If you provide a D3D_FEATURE_LEVEL array that contains D3D_FEATURE_LEVEL_11_1 on a computer that doesn't have the Direct3D 11.1 runtime installed, this function immediately fails with E_INVALIDARG. -
-
 
- The number of elements in pFeatureLevels. - The SDK version; use D3D11_SDK_VERSION. - Returns the address of a pointer to an ID3D11Device object that represents the device created. If this parameter is NULL, no ID3D11Device will be returned. - If successful, returns the first D3D_FEATURE_LEVEL from the pFeatureLevels array which succeeded. Supply NULL as an input if you don't need to determine which feature level is supported. - Returns the address of a pointer to an ID3D11DeviceContext object that represents the device context. If this parameter is NULL, no ID3D11DeviceContext will be returned. +
+ Note  If the Direct3D 11.1 runtime is present on the computer and pFeatureLevels is set to NULL, this function won't create a D3D_FEATURE_LEVEL_11_1 device. To create a D3D_FEATURE_LEVEL_11_1 device, you must explicitly provide a D3D_FEATURE_LEVEL array that includes D3D_FEATURE_LEVEL_11_1. If you provide a D3D_FEATURE_LEVEL array that contains D3D_FEATURE_LEVEL_11_1 on a computer that doesn't have the Direct3D 11.1 runtime installed, this function immediately fails with E_INVALIDARG. +
+
 
+ + + The number of elements in pFeatureLevels. + + + The SDK version; use D3D11_SDK_VERSION. + + + Returns the address of a pointer to an ID3D11Device object that represents the device created. If this parameter is NULL, no ID3D11Device will be returned. + + + If successful, returns the first D3D_FEATURE_LEVEL from the pFeatureLevels array which succeeded. Supply NULL as an input if you don't need to determine which feature level is supported. + + + Returns the address of a pointer to an ID3D11DeviceContext object that represents the device context. If this parameter is NULL, no ID3D11DeviceContext will be returned. + Get a description of how a resource is bound to a shader. - Microsoft Docs: + + Microsoft Docs: + The constant-buffer name of the resource. - A pointer to an input-binding description. See D3D11_SHADER_INPUT_BIND_DESC. + + A pointer to an input-binding description. See D3D11_SHADER_INPUT_BIND_DESC. + Allows the driver to return IHV specific information used when initializing the new hardware key. - Microsoft Docs: - A pointer to the ID3D11CryptoSession interface. To get this pointer, call ID3D11VideoDevice1::CreateCryptoSession. - The size of the memory referenced by the pPrivateInputData parameter. + + Microsoft Docs: + + + A pointer to the ID3D11CryptoSession interface. To get this pointer, call ID3D11VideoDevice1::CreateCryptoSession. + + + The size of the memory referenced by the pPrivateInputData parameter. + The private input data. The contents of this parameter is defined by the implementation of the secure execution environment. It may contain data about the license or about the stream properties. A pointer to the private output data. The return data is defined by the implementation of the secure execution environment. It may contain graphics-specific data to be associated with the underlying hardware key. @@ -10904,107 +15155,158 @@ If Format is not D3D11_VIDEO_PROCESSOR_STEREO_FORMAT_MONO_OFFSET, Gets the minimum level-of-detail (LOD). - Microsoft Docs: - A pointer to an ID3D11Resource which represents the resource. + + Microsoft Docs: + + + A pointer to an ID3D11Resource which represents the resource. + Gets the description for depth-stencil state that you used to create the depth-stencil-state object. - Microsoft Docs: - A pointer to a D3D11_DEPTH_STENCIL_DESC structure that receives a description of the depth-stencil state. + + Microsoft Docs: + + + A pointer to a D3D11_DEPTH_STENCIL_DESC structure that receives a description of the depth-stencil state. + Get the array of scissor rectangles bound to the rasterizer stage. - Microsoft Docs: - The number of scissor rectangles (ranges between 0 and D3D11_VIEWPORT_AND_SCISSORRECT_OBJECT_COUNT_PER_PIPELINE) bound; set pRects to NULL to use pNumRects to see how many rectangles would be returned. - An array of scissor rectangles (see D3D11_RECT). If NumRects is greater than the number of scissor rects currently bound, then unused members of the array will contain 0. + + Microsoft Docs: + + + The number of scissor rectangles (ranges between 0 and D3D11_VIEWPORT_AND_SCISSORRECT_OBJECT_COUNT_PER_PIPELINE) bound; set pRects to NULL to use pNumRects to see how many rectangles would be returned. + + + An array of scissor rectangles (see D3D11_RECT). If NumRects is greater than the number of scissor rects currently bound, then unused members of the array will contain 0. + Get a pointer to the index buffer that is bound to the input-assembler stage. - Microsoft Docs: - A pointer to an index buffer returned by the method (see ID3D11Buffer). - Specifies format of the data in the index buffer (see DXGI_FORMAT). These formats provide the size and type of - the data in the buffer. The only formats allowed for index buffer data are 16-bit (DXGI_FORMAT_R16_UINT) and 32-bit (DXGI_FORMAT_R32_UINT) - integers. + + Microsoft Docs: + + + A pointer to an index buffer returned by the method (see ID3D11Buffer). + + + Specifies format of the data in the index buffer (see DXGI_FORMAT). These formats provide the size and type of + the data in the buffer. The only formats allowed for index buffer data are 16-bit (DXGI_FORMAT_R16_UINT) and 32-bit (DXGI_FORMAT_R32_UINT) + integers. + Offset (in bytes) from the start of the index buffer, to the first index to use. A vertex-shader interface manages an executable program (a vertex shader) that controls the vertex-shader stage. - Microsoft Docs: + + Microsoft Docs: + Describes a trace step, which is an instruction. - Microsoft Docs: + + Microsoft Docs: + - A number that identifies the instruction, as an offset into the executable instructions that are present in the shader. + + A number that identifies the instruction, as an offset into the executable instructions that are present in the shader. -HLSL debugging information uses the same convention. Therefore, HLSL instructions are matched to a set of IDs. You can then map an ID to a disassembled string that can be displayed to the user. + HLSL debugging information uses the same convention. Therefore, HLSL instructions are matched to a set of IDs. You can then map an ID to a disassembled string that can be displayed to the user. + A value that specifies whether the instruction is active. This value is TRUE if something happened; therefore, you should parse other data in this structure. Otherwise, nothing happened; for example, if an instruction is disabled due to flow control even though other pixels in the stamp execute it. - The number of registers for the instruction that are written to. The range of registers is [0...NumRegistersWritten-1]. You can pass a register number to the writtenRegisterIndex parameter of ID3D11ShaderTrace::GetWrittenRegister to retrieve individual write-register information. + + The number of registers for the instruction that are written to. The range of registers is [0...NumRegistersWritten-1]. You can pass a register number to the writtenRegisterIndex parameter of ID3D11ShaderTrace::GetWrittenRegister to retrieve individual write-register information. + - The number of registers for the instruction that are read from. The range of registers is [0...NumRegistersRead-1]. You can pass a register number to the readRegisterIndex parameter of ID3D11ShaderTrace::GetReadRegister to retrieve individual read-register information. + + The number of registers for the instruction that are read from. The range of registers is [0...NumRegistersRead-1]. You can pass a register number to the readRegisterIndex parameter of ID3D11ShaderTrace::GetReadRegister to retrieve individual read-register information. + - A number that specifies the type of instruction (for example, add, mul, and so on). You can ignore this member if you do not know the number for the instruction type. This member offers a minor convenience at the cost of bloating the trace slightly. You can use the ID member and map back to the original shader code to retrieve the full information about the instruction. + + A number that specifies the type of instruction (for example, add, mul, and so on). You can ignore this member if you do not know the number for the instruction type. This member offers a minor convenience at the cost of bloating the trace slightly. You can use the ID member and map back to the original shader code to retrieve the full information about the instruction. + - The global cycle count for this step. You can use this member to correlate parallel thread execution via multiple simultaneous traces, for example, for the compute shader. - + + The global cycle count for this step. You can use this member to correlate parallel thread execution via multiple simultaneous traces, for example, for the compute shader. -
Note  Multiple threads at the same point in execution might log the same CurrentGlobalCycle. -
-
 
 + +
+ Note  Multiple threads at the same point in execution might log the same CurrentGlobalCycle. +
+
 
+ Gets information about the features that are supported by the current graphics driver. - Microsoft Docs: - A member of the D3D11_FEATURE enumerated type that describes which feature to query for support. + + Microsoft Docs: + + + A member of the D3D11_FEATURE enumerated type that describes which feature to query for support. + Upon completion of the method, the passed structure is filled with data that describes the feature support. - The size of the structure passed to the pFeatureSupportData parameter. + + The size of the structure passed to the pFeatureSupportData parameter. + Sets a swap chain that the runtime will use for automatically calling IDXGISwapChain::Present. - Microsoft Docs: - Swap chain that the runtime will use for automatically calling IDXGISwapChain::Present; must have been created with the DXGI_SWAP_EFFECT_SEQUENTIAL swap-effect flag. + + Microsoft Docs: + + + Swap chain that the runtime will use for automatically calling IDXGISwapChain::Present; must have been created with the DXGI_SWAP_EFFECT_SEQUENTIAL swap-effect flag. + Get a shader-reflection-variable type by name. - Microsoft Docs: + + Microsoft Docs: + Member name. Gets a handle to the driver. - Microsoft Docs: + + Microsoft Docs: + Receives a handle to the driver. Specifies a YCbCr color value. - Microsoft Docs: + + Microsoft Docs: + @@ -11022,119 +15324,160 @@ HLSL debugging information uses the same convention. Therefore, HLSL instruction Gets the description for rasterizer state that you used to create the rasterizer-state object. - Microsoft Docs: - A pointer to a D3D11_RASTERIZER_DESC1 structure that receives a description of the rasterizer state. This rasterizer state can specify forced sample count. + + Microsoft Docs: + + + A pointer to a D3D11_RASTERIZER_DESC1 structure that receives a description of the rasterizer state. This rasterizer state can specify forced sample count. + Opens a handle for a shared fence by using HANDLE and REFIID. - Microsoft Docs: - The handle that was returned by a call to ID3D11Fence::CreateSharedHandle or ID3D12Device::CreateSharedHandle. - The globally unique identifier (GUID) for the ID3D11Fence interface. The REFIID, or GUID, of the interface can be obtained by using the __uuidof() macro. For example, __uuidof(ID3D11Fence) will get the GUID of the interface to the fence. - A pointer to a memory block that receives a pointer to the ID3D11Fence interface. + + Microsoft Docs: + + + The handle that was returned by a call to ID3D11Fence::CreateSharedHandle or ID3D12Device::CreateSharedHandle. + + + The globally unique identifier (GUID) for the ID3D11Fence interface. The REFIID, or GUID, of the interface can be obtained by using the __uuidof() macro. For example, __uuidof(ID3D11Fence) will get the GUID of the interface to the fence. + + + A pointer to a memory block that receives a pointer to the ID3D11Fence interface. + A shader-reflection interface accesses shader information. - Microsoft Docs: + + Microsoft Docs: + A 3D texture interface represents texel data, which is structured memory. - Microsoft Docs: + + Microsoft Docs: + A geometry-shader interface manages an executable program (a geometry shader) that controls the geometry-shader stage. - Microsoft Docs: + + Microsoft Docs: + A view interface specifies the parts of a resource the pipeline can access during rendering. - Microsoft Docs: + + Microsoft Docs: + Describes a trace value. - Microsoft Docs: + + Microsoft Docs: + - An array of bits that make up the trace value. The [0] element is X. - + + An array of bits that make up the trace value. The [0] element is X. -
Note  This member can hold float, UINT, or INT data. - The elements are specified as UINT rather than using a union to minimize the risk of x86 SNaN->QNaN quashing during float assignment. - If the bits are displayed, they can be interpreted as float at the last moment. -
-
 
 + +
+ Note  This member can hold float, UINT, or INT data. + The elements are specified as UINT rather than using a union to minimize the risk of x86 SNaN->QNaN quashing during float assignment. + If the bits are displayed, they can be interpreted as float at the last moment. +
+
 
+ - A combination of the following component values that are combined by using a bitwise OR operation. - The resulting value specifies the component trace mask. - + + A combination of the following component values that are combined by using a bitwise OR operation. + The resulting value specifies the component trace mask. - - - - - - - - - - - - - - - - - - - - - -
FlagDescription
D3D11_TRACE_COMPONENT_X (0x1)The x component of the trace mask.
D3D11_TRACE_COMPONENT_Y (0x2)The y component of the trace mask.
D3D11_TRACE_COMPONENT_Z (0x4)The depth z component of the trace mask.
D3D11_TRACE_COMPONENT_W (0x8)The depth w component of the trace mask.
-  -Ignore unmasked values, particularly if deltas are accumulated. + + + + + + + + + + + + + + + + + + + + + +
FlagDescription
D3D11_TRACE_COMPONENT_X (0x1)The x component of the trace mask.
D3D11_TRACE_COMPONENT_Y (0x2)The y component of the trace mask.
D3D11_TRACE_COMPONENT_Z (0x4)The depth z component of the trace mask.
D3D11_TRACE_COMPONENT_W (0x8)The depth w component of the trace mask.
+   + + Ignore unmasked values, particularly if deltas are accumulated. + Get the target output buffers for the stream-output stage of the pipeline. - Microsoft Docs: + + Microsoft Docs: + Number of buffers to get. - An array of output buffers (see ID3D11Buffer) to be retrieved from the device. + + An array of output buffers (see ID3D11Buffer) to be retrieved from the device. + Clears an unordered access resource with bit-precise values. - Microsoft Docs: - The ID3D11UnorderedAccessView to clear. + + Microsoft Docs: + + + The ID3D11UnorderedAccessView to clear. + Values to copy to corresponding channels, see remarks. Get an array of sampler state interfaces from the geometry shader pipeline stage. - Microsoft Docs: + + Microsoft Docs: + Index into a zero-based array to begin getting samplers from (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers to get from a device context. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). + + Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). + Describes a sub sample mapping block. - Microsoft Docs: + + Microsoft Docs: + @@ -11146,35 +15489,49 @@ Ignore unmasked values, particularly if deltas are accumulated. Get the number of messages that were discarded due to the message count limit. - Microsoft Docs: + + Microsoft Docs: + Gets the number of decoder configurations that the driver supports for a specified video description. - Microsoft Docs: - A pointer to a D3D11_VIDEO_DECODER_DESC structure that describes the video stream. + + Microsoft Docs: + + + A pointer to a D3D11_VIDEO_DECODER_DESC structure that describes the video stream. + Receives the number of decoder configurations. Gets a description of how a resource is bound to a function. - Microsoft Docs: + + Microsoft Docs: + A zero-based resource index. - A pointer to a D3D11_SHADER_INPUT_BIND_DESC structure that describes input binding of the resource. + + A pointer to a D3D11_SHADER_INPUT_BIND_DESC structure that describes input binding of the resource. + Identifies the output surfaces that can be accessed during video processing. - Microsoft Docs: + + Microsoft Docs: + Blend factors, which modulate values for the pixel shader and render target. - Microsoft Docs: + + Microsoft Docs: + @@ -11196,26 +15553,40 @@ Ignore unmasked values, particularly if deltas are accumulated. The blend factor is ( 1 - Aₛ, 1 - Aₛ, 1 - Aₛ, 1 - Aₛ), that is alpha data (A) from a pixel shader. The pre-blend operation inverts the data, generating 1 - A. - The blend factor is (Ad Ad Ad Ad), that is alpha data from a render target. No pre-blend operation. + + The blend factor is (Ad Ad Ad Ad), that is alpha data from a render target. No pre-blend operation. + - The blend factor is (1 - Ad 1 - Ad 1 - Ad 1 - Ad), that is alpha data from a render target. The pre-blend operation inverts the data, generating 1 - A. + + The blend factor is (1 - Ad 1 - Ad 1 - Ad 1 - Ad), that is alpha data from a render target. The pre-blend operation inverts the data, generating 1 - A. + - The blend factor is (Rd, Gd, Bd, Ad), that is color data from a render target. No pre-blend operation. + + The blend factor is (Rd, Gd, Bd, Ad), that is color data from a render target. No pre-blend operation. + - The blend factor is (1 - Rd, 1 - Gd, 1 - Bd, 1 - Ad), that is color data from a render target. The pre-blend operation inverts the data, generating 1 - RGB. + + The blend factor is (1 - Rd, 1 - Gd, 1 - Bd, 1 - Ad), that is color data from a render target. The pre-blend operation inverts the data, generating 1 - RGB. + - The blend factor is (f, f, f, 1); where f = min(Aₛ, 1 - - Ad). The pre-blend operation clamps the data to 1 or less. + + The blend factor is (f, f, f, 1); where f = min(Aₛ, 1 + - Ad). The pre-blend operation clamps the data to 1 or less. + - The blend factor is the blend factor set with ID3D11DeviceContext::OMSetBlendState. No pre-blend operation. + + The blend factor is the blend factor set with ID3D11DeviceContext::OMSetBlendState. No pre-blend operation. + - The blend factor is the blend factor set with ID3D11DeviceContext::OMSetBlendState. The pre-blend operation inverts the blend factor, generating 1 - blend_factor. + + The blend factor is the blend factor set with ID3D11DeviceContext::OMSetBlendState. The pre-blend operation inverts the blend factor, generating 1 - blend_factor. + The blend factor is data sources both as color data output by a pixel shader. There is no pre-blend operation. This blend factor supports dual-source color blending. @@ -11232,7 +15603,9 @@ Ignore unmasked values, particularly if deltas are accumulated. Rebinds a constant buffer by name to a destination slot. - Microsoft Docs: + + Microsoft Docs: + The name of the constant buffer for rebinding. The destination slot number for rebinding. The offset in bytes of the destination slot for rebinding. The offset must have 16-byte alignment. @@ -11241,65 +15614,109 @@ Ignore unmasked values, particularly if deltas are accumulated. Sets all the elements in a resource view to one value. - Microsoft Docs: - A pointer to the ID3D11View interface that represents the resource view to clear. + + Microsoft Docs: + + + A pointer to the ID3D11View interface that represents the resource view to clear. + A 4-component array that represents the color to use to clear the resource view. - An array of D3D11_RECT structures for the rectangles in the resource view to clear. If NULL, ClearView clears the entire surface. - Number of rectangles in the array that the pRect parameter specifies. + + An array of D3D11_RECT structures for the rectangles in the resource view to clear. If NULL, ClearView clears the entire surface. + + + Number of rectangles in the array that the pRect parameter specifies. + Creates a render-target view for accessing resource data. - Microsoft Docs: - Pointer to a ID3D11Resource that represents a render target. This resource must have been created with the D3D11_BIND_RENDER_TARGET flag. - Pointer to a D3D11_RENDER_TARGET_VIEW_DESC1 that represents a render-target view description. Set this parameter to NULL to create a view that accesses all of the subresources in mipmap level 0. - A pointer to a memory block that receives a pointer to a ID3D11RenderTargetView1 interface for the created render-target view. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + + Microsoft Docs: + + + Pointer to a ID3D11Resource that represents a render target. This resource must have been created with the D3D11_BIND_RENDER_TARGET flag. + + + Pointer to a D3D11_RENDER_TARGET_VIEW_DESC1 that represents a render-target view description. Set this parameter to NULL to create a view that accesses all of the subresources in mipmap level 0. + + + A pointer to a memory block that receives a pointer to a ID3D11RenderTargetView1 interface for the created render-target view. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Get a query description. - Microsoft Docs: - Pointer to a query description (see D3D11_QUERY_DESC). + + Microsoft Docs: + + + Pointer to a query description (see D3D11_QUERY_DESC). + Get the rendering predicate state. - Microsoft Docs: - Address of a pointer to a predicate (see ID3D11Predicate). Value stored here will be NULL upon device creation. - Address of a boolean to fill with the predicate comparison value. FALSE upon device creation. + + Microsoft Docs: + + + Address of a pointer to a predicate (see ID3D11Predicate). Value stored here will be NULL upon device creation. + + + Address of a boolean to fill with the predicate comparison value. FALSE upon device creation. + Sends a query to an authenticated channel. - Microsoft Docs: - A pointer to the ID3D11AuthenticatedChannel interface. - The size of the pInput array, in bytes. - A pointer to a byte array that contains input data for the query. This array always starts with a D3D11_AUTHENTICATED_QUERY_INPUT structure. The QueryType member of the structure specifies the query and defines the meaning of the rest of the array. - The size of the pOutput array, in bytes. - A pointer to a byte array that receives the result of the query. This array always starts with a D3D11_AUTHENTICATED_QUERY_OUTPUT structure. The meaning of the rest of the array depends on the query. + + Microsoft Docs: + + + A pointer to the ID3D11AuthenticatedChannel interface. + + + The size of the pInput array, in bytes. + + + A pointer to a byte array that contains input data for the query. This array always starts with a D3D11_AUTHENTICATED_QUERY_INPUT structure. The QueryType member of the structure specifies the query and defines the meaning of the rest of the array. + + + The size of the pOutput array, in bytes. + + + A pointer to a byte array that receives the result of the query. This array always starts with a D3D11_AUTHENTICATED_QUERY_OUTPUT structure. The meaning of the rest of the array depends on the query. + Provides the video decoding and video processing capabilities of a Microsoft Direct3D 11 device. - Microsoft Docs: + + Microsoft Docs: + Gets the size of the driver's certificate chain. - Microsoft Docs: + + Microsoft Docs: + Receives the size of the certificate chain, in bytes. Identify a technique for resolving texture coordinates that are outside of the boundaries of a texture. - Microsoft Docs: + + Microsoft Docs: + @@ -11312,7 +15729,9 @@ Ignore unmasked values, particularly if deltas are accumulated. Texture coordinates outside the range [0.0, 1.0] are set to the texture color at 0.0 or 1.0, respectively. - Texture coordinates outside the range [0.0, 1.0] are set to the border color specified in D3D11_SAMPLER_DESC or HLSL code. + + Texture coordinates outside the range [0.0, 1.0] are set to the border color specified in D3D11_SAMPLER_DESC or HLSL code. + Similar to D3D11_TEXTURE_ADDRESS_MIRROR and D3D11_TEXTURE_ADDRESS_CLAMP. Takes the absolute value of the texture coordinate (thus, mirroring around 0), and then clamps to the maximum value. @@ -11320,7 +15739,9 @@ Ignore unmasked values, particularly if deltas are accumulated. Gives a device access to a shared resource that is referenced by a handle and that was created on a different device. - Microsoft Docs: + + Microsoft Docs: + A handle to the resource to open. For more info about this parameter, see Remarks. The globally unique identifier (GUID) for the resource interface. For more info about this parameter, see Remarks. A pointer to a variable that receives a pointer to the interface for the shared resource object to access. @@ -11329,24 +15750,36 @@ Ignore unmasked values, particularly if deltas are accumulated. Creates a query object for querying information from the graphics processing unit (GPU). - Microsoft Docs: - Pointer to a D3D11_QUERY_DESC1 structure that represents a query description. - A pointer to a memory block that receives a pointer to a ID3D11Query1 interface for the created query object. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + + Microsoft Docs: + + + Pointer to a D3D11_QUERY_DESC1 structure that represents a query description. + + + A pointer to a memory block that receives a pointer to a ID3D11Query1 interface for the created query object. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Describes information about Direct3D 11.1 adapter architecture. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether a rendering device batches rendering commands and performs multipass rendering into tiles or bins over a render area. Certain API usage patterns that are fine for TileBasedDefferredRenderers (TBDRs) can perform worse on non-TBDRs and vice versa. Applications that are careful about rendering can be friendly to both TBDR and non-TBDR architectures. TRUE if the rendering device batches rendering commands and FALSE otherwise. + + Specifies whether a rendering device batches rendering commands and performs multipass rendering into tiles or bins over a render area. Certain API usage patterns that are fine for TileBasedDefferredRenderers (TBDRs) can perform worse on non-TBDRs and vice versa. Applications that are careful about rendering can be friendly to both TBDR and non-TBDR architectures. TRUE if the rendering device batches rendering commands and FALSE otherwise. + Device context options. - Microsoft Docs: + + Microsoft Docs: + @@ -11358,50 +15791,63 @@ Ignore unmasked values, particularly if deltas are accumulated. Indicates the tier level at which tiled resources are supported. - Microsoft Docs: + + Microsoft Docs: + Tiled resources are not supported. - Tier_1 tiled resources are supported. + + Tier_1 tiled resources are supported. -The device supports calls to CreateTexture2D and so on with the D3D11_RESOURCE_MISC_TILED flag. - + The device supports calls to CreateTexture2D and so on with the D3D11_RESOURCE_MISC_TILED flag. -The device supports calls to CreateBuffer with the D3D11_RESOURCE_MISC_TILE_POOL flag. - -If you access tiles (read or write) that are NULL-mapped, you get undefined behavior, which includes device-removed. Apps can map all tiles to a single "default" tile to avoid this condition. + The device supports calls to CreateBuffer with the D3D11_RESOURCE_MISC_TILE_POOL flag. + + + If you access tiles (read or write) that are NULL-mapped, you get undefined behavior, which includes device-removed. Apps can map all tiles to a single "default" tile to avoid this condition. + - Tier_2 tiled resources are supported. - + + Tier_2 tiled resources are supported. -Superset of Tier_1 functionality, which includes this additional support: - -
    -
  • On Tier_1, if the size of a texture mipmap level is an integer multiple of the standard tile shape for its format, it is guaranteed to be nonpacked. On Tier_2, this guarantee is expanded to include mipmap levels whose size is at least one standard tile shape. - For more info, see D3D11_PACKED_MIP_DESC. -
    • -
  • Shader instructions are available for clamping level-of-detail (LOD) and for obtaining status about the shader operation. For info about one of these shader instructions, see Sample(S,float,int,float,uint). -
    • -
  • Reading from NULL-mapped tiles treat that sampled value as zero. Writes to NULL-mapped tiles are discarded. -
    • -
 + Superset of Tier_1 functionality, which includes this additional support: + + +
    +
  • + On Tier_1, if the size of a texture mipmap level is an integer multiple of the standard tile shape for its format, it is guaranteed to be nonpacked. On Tier_2, this guarantee is expanded to include mipmap levels whose size is at least one standard tile shape. + For more info, see D3D11_PACKED_MIP_DESC. +
    • +
  • + Shader instructions are available for clamping level-of-detail (LOD) and for obtaining status about the shader operation. For info about one of these shader instructions, see Sample(S,float,int,float,uint). +
    • +
  • + Reading from NULL-mapped tiles treat that sampled value as zero. Writes to NULL-mapped tiles are discarded. +
    • +
+ - Tier_3 tiled resources are supported. - + + Tier_3 tiled resources are supported. -Superset of Tier_2 functionality, Tier 3 is essentially Tier 2 but with the additional support of Texture3D for Tiled Resources. + + Superset of Tier_2 functionality, Tier 3 is essentially Tier 2 but with the additional support of Texture3D for Tiled Resources. + Specifies the subresources from an array of multisampled 2D textures for a depth-stencil view. - Microsoft Docs: + + Microsoft Docs: + @@ -11413,11 +15859,15 @@ Superset of Tier_2 functionality, Tier 3 is essentially Tier 2 but with the addi Describes a counter. - Microsoft Docs: + + Microsoft Docs: + - Type of counter (see D3D11_COUNTER). + + Type of counter (see D3D11_COUNTER). + Reserved. @@ -11425,16 +15875,24 @@ Superset of Tier_2 functionality, Tier 3 is essentially Tier 2 but with the addi Provides access to subresource data. - Microsoft Docs: + + Microsoft Docs: + - Pointer to the data. When ID3D11DeviceContext::Map provides the pointer, the runtime ensures that the pointer has a specific alignment, depending on the following feature levels: + + Pointer to the data. When ID3D11DeviceContext::Map provides the pointer, the runtime ensures that the pointer has a specific alignment, depending on the following feature levels: - + + The row pitch, or width, or physical size (in bytes) of the data. @@ -11445,18 +15903,24 @@ Superset of Tier_2 functionality, Tier 3 is essentially Tier 2 but with the addi Set a bit field of flags that will turn debug features on and off. - Microsoft Docs: + + Microsoft Docs: + A combination of feature-mask flags that are combined by using a bitwise OR operation. If a flag is present, that feature will be set to on, otherwise the feature will be set to off. For descriptions of the feature-mask flags, see Remarks. Debug message filter; contains a lists of message types to allow or deny. - Microsoft Docs: + + Microsoft Docs: + - Types of messages that you want to allow. See D3D11_INFO_QUEUE_FILTER_DESC. + + Types of messages that you want to allow. See D3D11_INFO_QUEUE_FILTER_DESC. + Types of messages that you want to deny. @@ -11464,23 +15928,35 @@ Superset of Tier_2 functionality, Tier 3 is essentially Tier 2 but with the addi Adds a clip plane with the plane coefficients taken from a cbuffer entry for 10Level9 shaders. - Microsoft Docs: - The cbuffer slot number. - The cbuffer entry number. + + Microsoft Docs: + + + The cbuffer slot number. + + + The cbuffer entry number. + Allows applications to annotate graphics commands. - Microsoft Docs: - An optional string that will be logged to ETW when ETW logging is active. If ‘#d’ appears in the string, it will be replaced by the value of the Data parameter similar to the way printf works. + + Microsoft Docs: + + + An optional string that will be logged to ETW when ETW logging is active. If ‘#d’ appears in the string, it will be replaced by the value of the Data parameter similar to the way printf works. + A signed data value that will be logged to ETW when ETW logging is active. Describes Direct3D 11.3 feature options in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + @@ -11489,46 +15965,68 @@ Superset of Tier_2 functionality, Tier 3 is essentially Tier 2 but with the addi Describes whether simple instancing is supported. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether the hardware and driver support simple instancing. The runtime sets this member to TRUE if the hardware and driver support simple instancing. + + Specifies whether the hardware and driver support simple instancing. The runtime sets this member to TRUE if the hardware and driver support simple instancing. + Initializes a class-instance object that represents an HLSL class instance. - Microsoft Docs: + + Microsoft Docs: + The type name of a class to initialize. Identifies the constant buffer that contains the class data. The four-component vector offset from the start of the constant buffer where the class data will begin. Consequently, this is not a byte offset. The texture slot for the first texture; there may be multiple textures following the offset. The sampler slot for the first sampler; there may be multiple samplers following the offset. - The address of a pointer to an ID3D11ClassInstance interface to initialize. + + The address of a pointer to an ID3D11ClassInstance interface to initialize. + Queries whether the video processor supports a specified video format. - Microsoft Docs: - The video format to query, specified as a DXGI_FORMAT value. - Receives a bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_FORMAT_SUPPORT enumeration. + + Microsoft Docs: + + + The video format to query, specified as a DXGI_FORMAT value. + + + Receives a bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_FORMAT_SUPPORT enumeration. + A debug message in the Information Queue. - Microsoft Docs: + + Microsoft Docs: + - The category of the message. See D3D11_MESSAGE_CATEGORY. + + The category of the message. See D3D11_MESSAGE_CATEGORY. + - The severity of the message. See D3D11_MESSAGE_SEVERITY. + + The severity of the message. See D3D11_MESSAGE_SEVERITY. + - The ID of the message. See D3D11_MESSAGE_ID. + + The ID of the message. See D3D11_MESSAGE_ID. + The message string. @@ -11539,7 +16037,9 @@ Superset of Tier_2 functionality, Tier 3 is essentially Tier 2 but with the addi Retrieves optional sizes for private driver data. - Microsoft Docs: + + Microsoft Docs: + Indicates the crypto type for which the private input and output size is queried. Indicates the decoder profile for which the private input and output size is queried. Indicates the key exchange type for which the private input and output size is queried. @@ -11550,25 +16050,33 @@ Superset of Tier_2 functionality, Tier 3 is essentially Tier 2 but with the addi Sets the specified pixel-shader stamp. - Microsoft Docs: + + Microsoft Docs: + The index of the stamp to select. Describes the subresource from a 2D texture to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + - Index of the most detailed mipmap level to use; this number is between 0 and (MipLevels (from the original Texture2D for which - ID3D11Device3::CreateShaderResourceView1creates a view) - 1 ). + + Index of the most detailed mipmap level to use; this number is between 0 and (MipLevels (from the original Texture2D for which + ID3D11Device3::CreateShaderResourceView1creates a view) - 1 ). + - The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. - + + The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. -Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + + Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + The index (plane slice number) of the plane to use in the texture. @@ -11576,53 +16084,87 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Set the eviction priority of a resource. - Microsoft Docs: + + Microsoft Docs: + Get the compute shader currently set on the device. - Microsoft Docs: - Address of a pointer to a Compute shader (see ID3D11ComputeShader) to be returned by the method. - Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + + Microsoft Docs: + + + Address of a pointer to a Compute shader (see ID3D11ComputeShader) to be returned by the method. + + + Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + The number of class-instance elements in the array. Creates a channel to communicate with the Microsoft Direct3D device or the graphics driver. - Microsoft Docs: - Specifies the type of channel, as a member of the D3D11_AUTHENTICATED_CHANNEL_TYPE enumeration. - Receives a pointer to the ID3D11AuthenticatedChannel interface. The caller must release the interface. + + Microsoft Docs: + + + Specifies the type of channel, as a member of the D3D11_AUTHENTICATED_CHANNEL_TYPE enumeration. + + + Receives a pointer to the ID3D11AuthenticatedChannel interface. The caller must release the interface. + Add storage filters to the top of the storage-filter stack. - Microsoft Docs: - Array of storage filters (see D3D11_INFO_QUEUE_FILTER). + + Microsoft Docs: + + + Array of storage filters (see D3D11_INFO_QUEUE_FILTER). + Sets the constant buffers that the geometry shader pipeline stage uses. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffers (see ID3D11Buffer) being given to the device. - An array that holds the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. Each offset must be a multiple of 16 constants. - An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + + Array of constant buffers (see ID3D11Buffer) being given to the device. + + + An array that holds the offsets into the buffers that ppConstantBuffers specifies. Each offset specifies where, from the shader's point of view, each constant buffer starts. Each offset is measured in shader constants, which are 16 bytes (4*32-bit components). Therefore, an offset of 16 indicates that the start of the associated constant buffer is 256 bytes into the constant buffer. Each offset must be a multiple of 16 constants. + + + An array that holds the numbers of constants in the buffers that ppConstantBuffers specifies. Each number specifies the number of constants that are contained in the constant buffer that the shader uses. Each number of constants starts from its respective offset that is specified in the pFirstConstant array. Each number of constants must be a multiple of 16 constants, in the range [0..4096]. + Passes a value with swizzle from a source linking node to a destination linking node. - Microsoft Docs: - A pointer to the ID3D11LinkingNode interface for the source linking node. + + Microsoft Docs: + + + A pointer to the ID3D11LinkingNode interface for the source linking node. + The zero-based index of the source parameter. The name of the source swizzle. - A pointer to the ID3D11LinkingNode interface for the destination linking node. + + A pointer to the ID3D11LinkingNode interface for the destination linking node. + The zero-based index of the destination parameter. The name of the destination swizzle. @@ -11630,7 +16172,9 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Data type of a performance counter. - Microsoft Docs: + + Microsoft Docs: + @@ -11648,7 +16192,9 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Specifies the protection level for video content. - Microsoft Docs: + + Microsoft Docs: + @@ -11666,86 +16212,132 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Specifies whether the video processor produces stereo video frames. - Microsoft Docs: - A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. - If TRUE, stereo output is enabled. Otherwise, the video processor produces mono video frames. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessor interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessor. + + + If TRUE, stereo output is enabled. Otherwise, the video processor produces mono video frames. + Execute a command list over one or more thread groups. - Microsoft Docs: - A pointer to an ID3D11Buffer, which must be loaded with data that matches the argument list for ID3D11DeviceContext::Dispatch. + + Microsoft Docs: + + + A pointer to an ID3D11Buffer, which must be loaded with data that matches the argument list for ID3D11DeviceContext::Dispatch. + A byte-aligned offset between the start of the buffer and the arguments. Get a boolean that turns the debug output on or off. - Microsoft Docs: + + Microsoft Docs: + Get the geometry shader currently set on the device. - Microsoft Docs: - Address of a pointer to a geometry shader (see ID3D11GeometryShader) to be returned by the method. - Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + + Microsoft Docs: + + + Address of a pointer to a geometry shader (see ID3D11GeometryShader) to be returned by the method. + + + Pointer to an array of class instance interfaces (see ID3D11ClassInstance). + The number of class-instance elements in the array. Set the constant buffers used by the hull-shader stage. - Microsoft Docs: - Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffers (see ID3D11Buffer) being given to the device. + + Microsoft Docs: + + + Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). + + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + + Array of constant buffers (see ID3D11Buffer) being given to the device. + Unregisters the "device removed" event. - Microsoft Docs: - Information about the "device removed" event, - retrieved during a successful RegisterDeviceRemovedEvent call. + + Microsoft Docs: + + + Information about the "device removed" event, + retrieved during a successful RegisterDeviceRemovedEvent call. + Set an array of sampler states to the geometry shader pipeline stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting samplers to (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers in the array. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + + Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + Bind an array of shader resources to the compute-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting shader resources to (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). Number of shader resources to set. Up to a maximum of 128 slots are available for shader resources(ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to set to the device. + + Array of shader resource view interfaces to set to the device. + Identifies the output surfaces that can be accessed during video decoding. - Microsoft Docs: + + Microsoft Docs: + Bind information about the primitive type, and data order that describes input data for the input assembler stage. - Microsoft Docs: - The type of primitive and ordering of the primitive data (see D3D11_PRIMITIVE_TOPOLOGY). + + Microsoft Docs: + + + The type of primitive and ordering of the primitive data (see D3D11_PRIMITIVE_TOPOLOGY). + Identifies expected resource use during rendering. The usage directly reflects whether a resource is accessible by the CPU and/or the graphics processing unit (GPU). - Microsoft Docs: + + Microsoft Docs: + @@ -11755,9 +16347,11 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down A resource that can only be read by the GPU. It cannot be written by the GPU, and cannot be accessed at all by the CPU. This type of resource must be initialized when it is created, since it cannot be changed after creation. - A resource that is accessible by both the GPU (read only) and the CPU (write only). A dynamic resource is a good choice for a resource that will be updated by the CPU at least once per frame. To update a dynamic resource, use a Map method. + + A resource that is accessible by both the GPU (read only) and the CPU (write only). A dynamic resource is a good choice for a resource that will be updated by the CPU at least once per frame. To update a dynamic resource, use a Map method. -For info about how to use dynamic resources, see How to: Use dynamic resources. + For info about how to use dynamic resources, see How to: Use dynamic resources. + A resource that supports data transfer (copy) from the GPU to the CPU. @@ -11765,104 +16359,164 @@ For info about how to use dynamic resources, see Describes Direct3D 11.1 feature options in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether logic operations are available in blend state. The runtime sets this member to TRUE if logic operations are available in blend state and FALSE otherwise. This member is FALSE for feature level 9.1, 9.2, and 9.3. This member is optional for feature level 10, 10.1, and 11. This member is TRUE for feature level 11.1. + + Specifies whether logic operations are available in blend state. The runtime sets this member to TRUE if logic operations are available in blend state and FALSE otherwise. This member is FALSE for feature level 9.1, 9.2, and 9.3. This member is optional for feature level 10, 10.1, and 11. This member is TRUE for feature level 11.1. + - Specifies whether the driver can render with no render target views (RTVs) or depth stencil views (DSVs), and only unordered access views (UAVs) bound. The runtime sets this member to TRUE if the driver can render with no RTVs or DSVs and only UAVs bound and FALSE otherwise. If TRUE, you can set the ForcedSampleCount member of D3D11_RASTERIZER_DESC1 to 1, 4, or 8 when you render with no RTVs or DSV and only UAVs bound. For feature level 11.1, this member is always TRUE and you can also set ForcedSampleCount to 16 in addition to 1, 4, or 8. The default value of ForcedSampleCount is 0, which means the same as if the value is set to 1. You can always set ForcedSampleCount to 0 or 1 for UAV-only rendering independently of how this member is set. + + Specifies whether the driver can render with no render target views (RTVs) or depth stencil views (DSVs), and only unordered access views (UAVs) bound. The runtime sets this member to TRUE if the driver can render with no RTVs or DSVs and only UAVs bound and FALSE otherwise. If TRUE, you can set the ForcedSampleCount member of D3D11_RASTERIZER_DESC1 to 1, 4, or 8 when you render with no RTVs or DSV and only UAVs bound. For feature level 11.1, this member is always TRUE and you can also set ForcedSampleCount to 16 in addition to 1, 4, or 8. The default value of ForcedSampleCount is 0, which means the same as if the value is set to 1. You can always set ForcedSampleCount to 0 or 1 for UAV-only rendering independently of how this member is set. + - Specifies whether the driver supports the ID3D11DeviceContext1::DiscardView and ID3D11DeviceContext1::DiscardResource methods. The runtime sets this member to TRUE if the driver supports these methods and FALSE otherwise. How this member is set does not indicate whether the driver actually uses these methods; that is, the driver might ignore these methods if they are not useful to the hardware. If FALSE, the runtime does not expose these methods to the driver because the driver does not support them. You can monitor this member during development to rule out legacy drivers on hardware where these methods might have otherwise been beneficial. You are not required to write separate code paths based on whether this member is TRUE or FALSE; you can call these methods whenever applicable. + + Specifies whether the driver supports the ID3D11DeviceContext1::DiscardView and ID3D11DeviceContext1::DiscardResource methods. The runtime sets this member to TRUE if the driver supports these methods and FALSE otherwise. How this member is set does not indicate whether the driver actually uses these methods; that is, the driver might ignore these methods if they are not useful to the hardware. If FALSE, the runtime does not expose these methods to the driver because the driver does not support them. You can monitor this member during development to rule out legacy drivers on hardware where these methods might have otherwise been beneficial. You are not required to write separate code paths based on whether this member is TRUE or FALSE; you can call these methods whenever applicable. + - Specifies whether the driver supports new semantics for copy and update that are exposed by the ID3D11DeviceContext1::CopySubresourceRegion1 and ID3D11DeviceContext1::UpdateSubresource1 methods. The runtime sets this member to TRUE if the driver supports new semantics for copy and update. The runtime sets this member to FALSE only for legacy drivers. The runtime handles this member similarly to the DiscardAPIsSeenByDriver member. + + Specifies whether the driver supports new semantics for copy and update that are exposed by the ID3D11DeviceContext1::CopySubresourceRegion1 and ID3D11DeviceContext1::UpdateSubresource1 methods. The runtime sets this member to TRUE if the driver supports new semantics for copy and update. The runtime sets this member to FALSE only for legacy drivers. The runtime handles this member similarly to the DiscardAPIsSeenByDriver member. + - Specifies whether the driver supports the ID3D11DeviceContext1::ClearView method. The runtime sets this member to TRUE if the driver supports this method and FALSE otherwise. If FALSE, the runtime does not expose this method to the driver because the driver does not support it. + + Specifies whether the driver supports the ID3D11DeviceContext1::ClearView method. The runtime sets this member to TRUE if the driver supports this method and FALSE otherwise. If FALSE, the runtime does not expose this method to the driver because the driver does not support it. -
Note  For feature level 9.1, 9.2, and 9.3, this member is always TRUE because the option is emulated by the runtime.
-
 
 +
+ Note  For feature level 9.1, 9.2, and 9.3, this member is always TRUE because the option is emulated by the runtime. +
+
 
+ - Specifies whether you can call ID3D11DeviceContext1::CopySubresourceRegion1 with overlapping source and destination rectangles. The runtime sets this member to TRUE if you can call CopySubresourceRegion1 with overlapping source and destination rectangles and FALSE otherwise. If FALSE, the runtime does not expose this method to the driver because the driver does not support it. + + Specifies whether you can call ID3D11DeviceContext1::CopySubresourceRegion1 with overlapping source and destination rectangles. The runtime sets this member to TRUE if you can call CopySubresourceRegion1 with overlapping source and destination rectangles and FALSE otherwise. If FALSE, the runtime does not expose this method to the driver because the driver does not support it. -
Note  For feature level 9.1, 9.2, and 9.3, this member is always TRUE because drivers already support the option for these feature levels.
-
 
 +
+ Note  For feature level 9.1, 9.2, and 9.3, this member is always TRUE because drivers already support the option for these feature levels. +
+
 
+ - Specifies whether the driver supports partial updates of constant buffers. The runtime sets this member to TRUE if the driver supports partial updates of constant buffers and FALSE otherwise. If FALSE, the runtime does not expose this operation to the driver because the driver does not support it. + + Specifies whether the driver supports partial updates of constant buffers. The runtime sets this member to TRUE if the driver supports partial updates of constant buffers and FALSE otherwise. If FALSE, the runtime does not expose this operation to the driver because the driver does not support it. -
Note  For feature level 9.1, 9.2, and 9.3, this member is always TRUE because the option is emulated by the runtime.
-
 
 +
+ Note  For feature level 9.1, 9.2, and 9.3, this member is always TRUE because the option is emulated by the runtime. +
+
 
+ - Specifies whether the driver supports new semantics for setting offsets in constant buffers for a shader. The runtime sets this member to TRUE if the driver supports allowing you to specify offsets when you call new methods like the ID3D11DeviceContext1::VSSetConstantBuffers1 method and FALSE otherwise. If FALSE, the runtime does not expose this operation to the driver because the driver does not support it. + + Specifies whether the driver supports new semantics for setting offsets in constant buffers for a shader. The runtime sets this member to TRUE if the driver supports allowing you to specify offsets when you call new methods like the ID3D11DeviceContext1::VSSetConstantBuffers1 method and FALSE otherwise. If FALSE, the runtime does not expose this operation to the driver because the driver does not support it. -
Note  For feature level 9.1, 9.2, and 9.3, this member is always TRUE because the option is emulated by the runtime.
-
 
 +
+ Note  For feature level 9.1, 9.2, and 9.3, this member is always TRUE because the option is emulated by the runtime. +
+
 
+ - Specifies whether you can call ID3D11DeviceContext::Map with D3D11_MAP_WRITE_NO_OVERWRITE on a dynamic constant buffer (that is, whether the driver supports this operation). The runtime sets this member to TRUE if the driver supports this operation and FALSE otherwise. If FALSE, the runtime fails this method because the driver does not support the operation. + + Specifies whether you can call ID3D11DeviceContext::Map with D3D11_MAP_WRITE_NO_OVERWRITE on a dynamic constant buffer (that is, whether the driver supports this operation). The runtime sets this member to TRUE if the driver supports this operation and FALSE otherwise. If FALSE, the runtime fails this method because the driver does not support the operation. -
Note  For feature level 9.1, 9.2, and 9.3, this member is always TRUE because the option is emulated by the runtime.
-
 
 +
+ Note  For feature level 9.1, 9.2, and 9.3, this member is always TRUE because the option is emulated by the runtime. +
+
 
+ - Specifies whether you can call ID3D11DeviceContext::Map with D3D11_MAP_WRITE_NO_OVERWRITE on a dynamic buffer SRV (that is, whether the driver supports this operation). The runtime sets this member to TRUE if the driver supports this operation and FALSE otherwise. If FALSE, the runtime fails this method because the driver does not support the operation. + + Specifies whether you can call ID3D11DeviceContext::Map with D3D11_MAP_WRITE_NO_OVERWRITE on a dynamic buffer SRV (that is, whether the driver supports this operation). The runtime sets this member to TRUE if the driver supports this operation and FALSE otherwise. If FALSE, the runtime fails this method because the driver does not support the operation. + - Specifies whether the driver supports multisample rendering when you render with RTVs bound. If TRUE, you can set the ForcedSampleCount member of D3D11_RASTERIZER_DESC1 to 1 with a multisample RTV bound. The driver can support this option on feature level 10 and higher. If FALSE, the rasterizer-state creation will fail because the driver is legacy or the feature level is too low. + + Specifies whether the driver supports multisample rendering when you render with RTVs bound. If TRUE, you can set the ForcedSampleCount member of D3D11_RASTERIZER_DESC1 to 1 with a multisample RTV bound. The driver can support this option on feature level 10 and higher. If FALSE, the rasterizer-state creation will fail because the driver is legacy or the feature level is too low. + - Specifies whether the hardware and driver support the msad4 intrinsic function in shaders. The runtime sets this member to TRUE if the hardware and driver support calls to msad4 intrinsic functions in shaders. If FALSE, the driver is legacy or the hardware does not support the option; the runtime will fail shader creation for shaders that use msad4. + + Specifies whether the hardware and driver support the msad4 intrinsic function in shaders. The runtime sets this member to TRUE if the hardware and driver support calls to msad4 intrinsic functions in shaders. If FALSE, the driver is legacy or the hardware does not support the option; the runtime will fail shader creation for shaders that use msad4. + - Specifies whether the hardware and driver support the fma intrinsic function and other extended doubles instructions (DDIV and DRCP) in shaders. The fma intrinsic function emits an extended doubles DFMA instruction. The runtime sets this member to TRUE if the hardware and driver support extended doubles instructions in shaders (shader model 5 and higher). Support of this option implies support of basic double-precision shader instructions as well. You can use the D3D11_FEATURE_DOUBLES value to query for support of double-precision shaders. If FALSE, the hardware and driver do not support the option; the runtime will fail shader creation for shaders that use extended doubles instructions. + + Specifies whether the hardware and driver support the fma intrinsic function and other extended doubles instructions (DDIV and DRCP) in shaders. The fma intrinsic function emits an extended doubles DFMA instruction. The runtime sets this member to TRUE if the hardware and driver support extended doubles instructions in shaders (shader model 5 and higher). Support of this option implies support of basic double-precision shader instructions as well. You can use the D3D11_FEATURE_DOUBLES value to query for support of double-precision shaders. If FALSE, the hardware and driver do not support the option; the runtime will fail shader creation for shaders that use extended doubles instructions. + - Specifies whether the hardware and driver have [extended support for shared Texture2D resource types and formats](/windows/win32/direct3d11/direct3d-11-1-features#extended-support-for-shared-texture2d-resources). The runtime sets this member to TRUE if the hardware and driver support extended Texture2D resource sharing. + + Specifies whether the hardware and driver have [extended support for shared Texture2D resource types and formats](/windows/win32/direct3d11/direct3d-11-1-features#extended-support-for-shared-texture2d-resources). The runtime sets this member to TRUE if the hardware and driver support extended Texture2D resource sharing. + Describes the blend state for a render target. - Microsoft Docs: + + Microsoft Docs: + - Enable (or disable) blending. + + Enable (or disable) blending. -> [!NOTE] -> It's not valid for LogicOpEnable and BlendEnable to both be TRUE. + > [!NOTE] + > It's not valid for LogicOpEnable and BlendEnable to both be TRUE. + - Enable (or disable) a logical operation. + + Enable (or disable) a logical operation. -> [!NOTE] -> If you set LogicOpEnable to TRUE, then BlendEnable must be FALSE, and the system's [D3D11_FEATURE_DATA_D3D11_OPTIONS::OutputMergerLogicOp](../d3d11/ns-d3d11-d3d11_feature_data_d3d11_options.md) option must be TRUE. + > [!NOTE] + > If you set LogicOpEnable to TRUE, then BlendEnable must be FALSE, and the system's [D3D11_FEATURE_DATA_D3D11_OPTIONS::OutputMergerLogicOp](../d3d11/ns-d3d11-d3d11_feature_data_d3d11_options.md) option must be TRUE. + - This blend option specifies the operation to perform on the RGB value that the pixel shader outputs. The BlendOp member defines how to combine the SrcBlend and DestBlend operations. + + This blend option specifies the operation to perform on the RGB value that the pixel shader outputs. The BlendOp member defines how to combine the SrcBlend and DestBlend operations. + - This blend option specifies the operation to perform on the current RGB value in the render target. The BlendOp member defines how to combine the SrcBlend and DestBlend operations. + + This blend option specifies the operation to perform on the current RGB value in the render target. The BlendOp member defines how to combine the SrcBlend and DestBlend operations. + - This blend operation defines how to combine the SrcBlend and DestBlend operations. + + This blend operation defines how to combine the SrcBlend and DestBlend operations. + - This blend option specifies the operation to perform on the alpha value that the pixel shader outputs. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + + This blend option specifies the operation to perform on the alpha value that the pixel shader outputs. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + - This blend option specifies the operation to perform on the current alpha value in the render target. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + + This blend option specifies the operation to perform on the current alpha value in the render target. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + - This blend operation defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + + This blend operation defines how to combine the SrcBlendAlpha and DestBlendAlpha operations. + - A D3D11_LOGIC_OP-typed value that specifies the logical operation to configure for the render target. + + A D3D11_LOGIC_OP-typed value that specifies the logical operation to configure for the render target. + A write mask. @@ -11870,11 +16524,15 @@ For info about how to use dynamic resources, see Information about the video card's performance counter capabilities. - Microsoft Docs: + + Microsoft Docs: + - Largest device-dependent counter ID that the device supports. If none are supported, this value will be 0. Otherwise it will be greater than or equal to D3D11_COUNTER_DEVICE_DEPENDENT_0. See D3D11_COUNTER. + + Largest device-dependent counter ID that the device supports. If none are supported, this value will be 0. Otherwise it will be greater than or equal to D3D11_COUNTER_DEVICE_DEPENDENT_0. See D3D11_COUNTER. + Number of counters that can be simultaneously supported. @@ -11885,137 +16543,205 @@ For info about how to use dynamic resources, see Get the retrieval filter at the top of the retrieval-filter stack. - Microsoft Docs: + + Microsoft Docs: + Retrieval filter at the top of the retrieval-filter stack. - Size of the retrieval filter in bytes. If pFilter is NULL, the size of the retrieval filter will be output to this parameter. + + Size of the retrieval filter in bytes. If pFilter is NULL, the size of the retrieval filter will be output to this parameter. + Get the storage filter at the top of the storage-filter stack. - Microsoft Docs: + + Microsoft Docs: + Storage filter at the top of the storage-filter stack. - Size of the storage filter in bytes. If pFilter is NULL, the size of the storage filter will be output to this parameter. + + Size of the storage filter in bytes. If pFilter is NULL, the size of the storage filter will be output to this parameter. + Create a depth-stencil view for accessing resource data. - Microsoft Docs: - Pointer to the resource that will serve as the depth-stencil surface. This resource must have been created with the D3D11_BIND_DEPTH_STENCIL flag. - Pointer to a depth-stencil-view description (see D3D11_DEPTH_STENCIL_VIEW_DESC). Set this parameter to NULL to create a view that accesses mipmap level 0 of the entire resource (using the format the resource was created with). - Address of a pointer to an ID3D11DepthStencilView. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + + Microsoft Docs: + + + Pointer to the resource that will serve as the depth-stencil surface. This resource must have been created with the D3D11_BIND_DEPTH_STENCIL flag. + + + Pointer to a depth-stencil-view description (see D3D11_DEPTH_STENCIL_VIEW_DESC). Set this parameter to NULL to create a view that accesses mipmap level 0 of the entire resource (using the format the resource was created with). + + + Address of a pointer to an ID3D11DepthStencilView. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Remove a retrieval filter from the top of the retrieval-filter stack. - Microsoft Docs: + + Microsoft Docs: + Describes Direct3D 11.3 feature options in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether the hardware and driver support PSSpecifiedStencilRef. - The runtime sets this member to TRUE if the hardware and driver support this option. + + Specifies whether the hardware and driver support PSSpecifiedStencilRef. + The runtime sets this member to TRUE if the hardware and driver support this option. + - Specifies whether the hardware and driver support TypedUAVLoadAdditionalFormats. - The runtime sets this member to TRUE if the hardware and driver support this option. + + Specifies whether the hardware and driver support TypedUAVLoadAdditionalFormats. + The runtime sets this member to TRUE if the hardware and driver support this option. + - Specifies whether the hardware and driver support ROVs. - The runtime sets this member to TRUE if the hardware and driver support this option. + + Specifies whether the hardware and driver support ROVs. + The runtime sets this member to TRUE if the hardware and driver support this option. + - Specifies whether the hardware and driver support conservative rasterization. - The runtime sets this member to a D3D11_CONSERVATIVE_RASTERIZATION_TIER-typed value that indicates if the hardware and driver support conservative rasterization and at what tier level. + + Specifies whether the hardware and driver support conservative rasterization. + The runtime sets this member to a D3D11_CONSERVATIVE_RASTERIZATION_TIER-typed value that indicates if the hardware and driver support conservative rasterization and at what tier level. + - Specifies whether the hardware and driver support tiled resources. - The runtime sets this member to a D3D11_TILED_RESOURCES_TIER-typed value that indicates if the hardware and driver support tiled resources and at what tier level. + + Specifies whether the hardware and driver support tiled resources. + The runtime sets this member to a D3D11_TILED_RESOURCES_TIER-typed value that indicates if the hardware and driver support tiled resources and at what tier level. + - Specifies whether the hardware and driver support mapping on default textures. - The runtime sets this member to TRUE if the hardware and driver support this option. + + Specifies whether the hardware and driver support mapping on default textures. + The runtime sets this member to TRUE if the hardware and driver support this option. + - Specifies whether the hardware and driver support standard swizzle. - The runtime sets this member to TRUE if the hardware and driver support this option. + + Specifies whether the hardware and driver support standard swizzle. + The runtime sets this member to TRUE if the hardware and driver support this option. + - Specifies whether the hardware and driver support Unified Memory Architecture. - The runtime sets this member to TRUE if the hardware and driver support this option. + + Specifies whether the hardware and driver support Unified Memory Architecture. + The runtime sets this member to TRUE if the hardware and driver support this option. + Describes a 2D texture. - Microsoft Docs: + + Microsoft Docs: + - Texture width (in texels). The range is from 1 to D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). For a texture cube-map, the range is from 1 to D3D11_REQ_TEXTURECUBE_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Texture width (in texels). The range is from 1 to D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). For a texture cube-map, the range is from 1 to D3D11_REQ_TEXTURECUBE_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - Texture height (in texels). The range is from 1 to D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). For a texture cube-map, the range is from 1 to D3D11_REQ_TEXTURECUBE_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Texture height (in texels). The range is from 1 to D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). For a texture cube-map, the range is from 1 to D3D11_REQ_TEXTURECUBE_DIMENSION (16384). However, the range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - The maximum number of mipmap levels in the texture. See the remarks in D3D11_TEX1D_SRV. Use 1 for a multisampled texture; or 0 to generate a full set of subtextures. + + The maximum number of mipmap levels in the texture. See the remarks in D3D11_TEX1D_SRV. Use 1 for a multisampled texture; or 0 to generate a full set of subtextures. + - Number of textures in the texture array. The range is from 1 to D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048). For a texture cube-map, this value is a multiple of 6 (that is, 6 times the value in the NumCubes member of D3D11_TEXCUBE_ARRAY_SRV), and the range is from 6 to 2046. The range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + + Number of textures in the texture array. The range is from 1 to D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048). For a texture cube-map, this value is a multiple of 6 (that is, 6 times the value in the NumCubes member of D3D11_TEXCUBE_ARRAY_SRV), and the range is from 6 to 2046. The range is actually constrained by the feature level at which you create the rendering device. For more information about restrictions, see Remarks. + - Texture format (see DXGI_FORMAT). + + Texture format (see DXGI_FORMAT). + - Structure that specifies multisampling parameters for the texture. See DXGI_SAMPLE_DESC. + + Structure that specifies multisampling parameters for the texture. See DXGI_SAMPLE_DESC. + - Value that identifies how the texture is to be read from and written to. The most common value is D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + + Value that identifies how the texture is to be read from and written to. The most common value is D3D11_USAGE_DEFAULT; see D3D11_USAGE for all possible values. + - Flags (see D3D11_BIND_FLAG) for binding to pipeline stages. The flags can be combined by a logical OR. + + Flags (see D3D11_BIND_FLAG) for binding to pipeline stages. The flags can be combined by a logical OR. + - Flags (see D3D11_CPU_ACCESS_FLAG) to specify the types of CPU access allowed. Use 0 if CPU access is not required. These flags can be combined with a logical OR. + + Flags (see D3D11_CPU_ACCESS_FLAG) to specify the types of CPU access allowed. Use 0 if CPU access is not required. These flags can be combined with a logical OR. + - Flags (see D3D11_RESOURCE_MISC_FLAG) that identify other, less common resource options. Use 0 if none of these flags apply. These flags can be combined by using a logical OR. For a texture cube-map, set the D3D11_RESOURCE_MISC_TEXTURECUBE flag. Cube-map arrays (that is, ArraySize > 6) require feature level D3D_FEATURE_LEVEL_10_1 or higher. + + Flags (see D3D11_RESOURCE_MISC_FLAG) that identify other, less common resource options. Use 0 if none of these flags apply. These flags can be combined by using a logical OR. For a texture cube-map, set the D3D11_RESOURCE_MISC_TEXTURECUBE flag. Cube-map arrays (that is, ArraySize > 6) require feature level D3D_FEATURE_LEVEL_10_1 or higher. + - A D3D11_TEXTURE_LAYOUT-typed value that identifies the layout of the texture. + + A D3D11_TEXTURE_LAYOUT-typed value that identifies the layout of the texture. -The TextureLayout parameter selects both the actual layout of the texture in memory and the layout visible to the application while the texture is mapped. These flags may not be requested without CPU access also requested. + The TextureLayout parameter selects both the actual layout of the texture in memory and the layout visible to the application while the texture is mapped. These flags may not be requested without CPU access also requested. -It is illegal to set CPU access flags on default textures without also setting TextureLayout to a value other than D3D11_TEXTURE_LAYOUT_UNDEFINED. + It is illegal to set CPU access flags on default textures without also setting TextureLayout to a value other than D3D11_TEXTURE_LAYOUT_UNDEFINED. -D3D11_TEXTURE_LAYOUT_ROW_MAJOR may only be used to create non-multisampled, textures with a single subresource (Planar YUV textures are supported). These textures may only be used as a source and destination of copy operations, and BindFlags must be zero. + D3D11_TEXTURE_LAYOUT_ROW_MAJOR may only be used to create non-multisampled, textures with a single subresource (Planar YUV textures are supported). These textures may only be used as a source and destination of copy operations, and BindFlags must be zero. -D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE may only be used to create non-multisampled, non-depth-stencil textures. + D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE may only be used to create non-multisampled, non-depth-stencil textures. + Get the number of messages that were denied passage through a storage filter. - Microsoft Docs: + + Microsoft Docs: + Verifies whether the dispatch pipeline state is valid. - Microsoft Docs: - A pointer to the ID3D11DeviceContext that represents a device context. + + Microsoft Docs: + + + A pointer to the ID3D11DeviceContext that represents a device context. + Specifies the subresources from a an array of multisampled 2D textures to use in a render-target view. - Microsoft Docs: + + Microsoft Docs: + @@ -12027,29 +16753,45 @@ D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE may only be used to create non-multisa Describes the capabilities of a Microsoft Direct3D 11 video processor. - Microsoft Docs: + + Microsoft Docs: + - A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_DEVICE_CAPS enumeration. + + A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_DEVICE_CAPS enumeration. + - A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_FEATURE_CAPS enumeration. + + A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_FEATURE_CAPS enumeration. + - A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSPR_FILTER_CAPS enumeration. + + A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSPR_FILTER_CAPS enumeration. + - A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_FORMAT_CAPS enumeration. + + A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_FORMAT_CAPS enumeration. + - A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_AUTO_STREAM_CAPS enumeration. + + A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_AUTO_STREAM_CAPS enumeration. + - A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_STEREO_CAPS enumeration. + + A bitwise OR of zero or more flags from the D3D11_VIDEO_PROCESSOR_STEREO_CAPS enumeration. + - The number of frame-rate conversion capabilities. To enumerate the frame-rate conversion capabilities, call the ID3D11VideoProcessorEnumerator::GetVideoProcessorRateConversionCaps method. + + The number of frame-rate conversion capabilities. To enumerate the frame-rate conversion capabilities, call the ID3D11VideoProcessorEnumerator::GetVideoProcessorRateConversionCaps method. + The maximum number of input streams that can be enabled at the same time. @@ -12060,37 +16802,55 @@ D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE may only be used to create non-multisa Waits until the specified fence reaches or exceeds the specified value before future work can begin. - Microsoft Docs: - A pointer to the ID3D11Fence object. - The value that the device context is waiting for the fence to reach or exceed. So when ID3D11Fence::GetCompletedValue is greater than or equal to Value, the wait is terminated. + + Microsoft Docs: + + + A pointer to the ID3D11Fence object. + + + The value that the device context is waiting for the fence to reach or exceed. So when ID3D11Fence::GetCompletedValue is greater than or equal to Value, the wait is terminated. + A linking-node interface is used for shader linking. - Microsoft Docs: + + Microsoft Docs: + Gets the depth-stencil state of the output-merger stage. - Microsoft Docs: - Address of a pointer to a depth-stencil state interface (see ID3D11DepthStencilState) to be filled with information from the device. + + Microsoft Docs: + + + Address of a pointer to a depth-stencil state interface (see ID3D11DepthStencilState) to be filled with information from the device. + Pointer to the stencil reference value used in the depth-stencil test. Gets a profile that is supported by the driver. - Microsoft Docs: - The zero-based index of the profile. To get the number of profiles that the driver supports, call ID3D11VideoDevice::GetVideoDecoderProfileCount. + + Microsoft Docs: + + + The zero-based index of the profile. To get the number of profiles that the driver supports, call ID3D11VideoDevice::GetVideoDecoderProfileCount. + Receives a GUID that identifies the profile. Specifies the subresource from a multisampled 2D texture that is accessible to a depth-stencil view. - Microsoft Docs: + + Microsoft Docs: + @@ -12099,45 +16859,65 @@ D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE may only be used to create non-multisa The tracing device interface sets shader tracking information, which enables accurate logging and playback of shader execution. - Microsoft Docs: + + Microsoft Docs: + Specifies the subresource from a cube texture to use in a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + - Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original TextureCube for which ID3D11Device::CreateShaderResourceView creates a view) -1. + + Index of the most detailed mipmap level to use; this number is between 0 and MipLevels (from the original TextureCube for which ID3D11Device::CreateShaderResourceView creates a view) -1. + - The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. + + The maximum number of mipmap levels for the view of the texture. See the remarks in D3D11_TEX1D_SRV. -Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + Set to -1 to indicate all the mipmap levels from MostDetailedMip on down to least detailed. + Create a domain shader. - Microsoft Docs: + + Microsoft Docs: + A pointer to a compiled shader. Size of the compiled shader. - A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. - Address of a pointer to a ID3D11DomainShader interface. If this is NULL, all other parameters will be validated, and if all parameters pass validation this API will return S_FALSE instead of S_OK. + + A pointer to a class linkage interface (see ID3D11ClassLinkage); the value can be NULL. + + + Address of a pointer to a ID3D11DomainShader interface. If this is NULL, all other parameters will be validated, and if all parameters pass validation this API will return S_FALSE instead of S_OK. + Gets the driver's certificate chain. - Microsoft Docs: - The size of the pCertificate array, in bytes. To get the size of the certificate chain, call ID3D11CryptoSession::GetCertificateSize. + + Microsoft Docs: + + + The size of the pCertificate array, in bytes. To get the size of the certificate chain, call ID3D11CryptoSession::GetCertificateSize. + A pointer to a byte array that receives the driver's certificate chain. The caller must allocate the array. Specifies how to access a resource that is used in a video decoding output view. - Microsoft Docs: + + Microsoft Docs: + @@ -12149,38 +16929,52 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Generates Microsoft High Level Shader Language (HLSL) shader code that represents the function-linking-graph. - Microsoft Docs: + + Microsoft Docs: + Reserved - An pointer to a variable that receives a pointer to the ID3DBlob interface that you can use to access the HLSL shader source code that represents the function-linking-graph. You can compile this HLSL code, but first you must add code or include statements for the functions called in the function-linking-graph. + + An pointer to a variable that receives a pointer to the ID3DBlob interface that you can use to access the HLSL shader source code that represents the function-linking-graph. You can compile this HLSL code, but first you must add code or include statements for the functions called in the function-linking-graph. + Represents key exchange input data for hardware content protection. - Microsoft Docs: + + Microsoft Docs: + - The size of the private data reserved for IHV usage. This size is determined from the pPrivateInputSize parameter returned by the ID3D11VideoDevice1::GetCryptoSessionPrivateDataSize function. + + The size of the private data reserved for IHV usage. This size is determined from the pPrivateInputSize parameter returned by the ID3D11VideoDevice1::GetCryptoSessionPrivateDataSize function. + The size of the DRM command data. - If PrivateDataSize is greater than 0, pbInput[0] – pbInput[PrivateDataSize - 1] is reserved for IHV use. + + If PrivateDataSize is greater than 0, pbInput[0] – pbInput[PrivateDataSize - 1] is reserved for IHV use. -pbInput[PrivateDataSize] – pbInput[HWProtectionDataSize + PrivateDataSize - 1] contains the input data for the DRM command. The format and size of the DRM command is defined by the DRM specification. + pbInput[PrivateDataSize] – pbInput[HWProtectionDataSize + PrivateDataSize - 1] contains the input data for the DRM command. The format and size of the DRM command is defined by the DRM specification. + A device-child interface accesses data used by a device. - Microsoft Docs: + + Microsoft Docs: + Options for the amount of information to report about a device object's lifetime. - Microsoft Docs: + + Microsoft Docs: + @@ -12195,14 +16989,20 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down Describes a video stream for a video processor. - Microsoft Docs: + + Microsoft Docs: + - A member of the D3D11_VIDEO_FRAME_FORMAT enumeration that describes how the video stream is interlaced. + + A member of the D3D11_VIDEO_FRAME_FORMAT enumeration that describes how the video stream is interlaced. + - The frame rate of the input video stream, specified as a DXGI_RATIONAL structure. + + The frame rate of the input video stream, specified as a DXGI_RATIONAL structure. + The width of the input frames, in pixels. @@ -12211,7 +17011,9 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down The height of the input frames, in pixels. - The frame rate of the output video stream, specified as a DXGI_RATIONAL structure. + + The frame rate of the output video stream, specified as a DXGI_RATIONAL structure. + The width of the output frames, in pixels. @@ -12220,142 +17022,228 @@ Set to -1 to indicate all the mipmap levels from MostDetailedMip on down The height of the output frames, in pixels. - A member of the D3D11_VIDEO_USAGE enumeration that describes how the video processor will be used. The value indicates the desired trade-off between speed and video quality. The driver uses this flag as a hint when it creates the video processor. + + A member of the D3D11_VIDEO_USAGE enumeration that describes how the video processor will be used. The value indicates the desired trade-off between speed and video quality. The driver uses this flag as a hint when it creates the video processor. + Sets the constant buffers used by the vertex shader pipeline stage. - Microsoft Docs: - Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffers (see ID3D11Buffer) being given to the device. + + Microsoft Docs: + + + Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). + + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + + Array of constant buffers (see ID3D11Buffer) being given to the device. + Creates a video processor device for Microsoft Direct3D 11. - Microsoft Docs: - A pointer to the ID3D11VideoProcessorEnumerator interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessorEnumerator. - Specifies the frame-rate conversion capabilities for the video processor. The value is a zero-based index that corresponds to the TypeIndex parameter of the ID3D11VideoProcessorEnumerator::GetVideoProcessorRateConversionCaps method. - Receives a pointer to the ID3D11VideoProcessor interface. The caller must release the interface. + + Microsoft Docs: + + + A pointer to the ID3D11VideoProcessorEnumerator interface. To get this pointer, call ID3D11VideoDevice::CreateVideoProcessorEnumerator. + + + Specifies the frame-rate conversion capabilities for the video processor. The value is a zero-based index that corresponds to the TypeIndex parameter of the ID3D11VideoProcessorEnumerator::GetVideoProcessorRateConversionCaps method. + + + Receives a pointer to the ID3D11VideoProcessor interface. The caller must release the interface. + Creates a view for accessing an unordered access resource. - Microsoft Docs: - Pointer to an ID3D11Resource that represents a resources that will serve as an input to a shader. - Pointer to a D3D11_UNORDERED_ACCESS_VIEW_DESC1 structure that represents an unordered-access view description. Set this parameter to NULL to create a view that accesses the entire resource (using the format the resource was created with). - A pointer to a memory block that receives a pointer to a ID3D11UnorderedAccessView1 interface for the created unordered-access view. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + + Microsoft Docs: + + + Pointer to an ID3D11Resource that represents a resources that will serve as an input to a shader. + + + Pointer to a D3D11_UNORDERED_ACCESS_VIEW_DESC1 structure that represents an unordered-access view description. Set this parameter to NULL to create a view that accesses the entire resource (using the format the resource was created with). + + + A pointer to a memory block that receives a pointer to a ID3D11UnorderedAccessView1 interface for the created unordered-access view. Set this parameter to NULL to validate the other input parameters (the method will return S_FALSE if the other input parameters pass validation). + Describes a shader-resource view. - Microsoft Docs: + + Microsoft Docs: + - A DXGI_FORMAT specifying the viewing format. See remarks. + + A DXGI_FORMAT specifying the viewing format. See remarks. + - The resource type of the view. See D3D11_SRV_DIMENSION. You must set ViewDimension to the same resource type as that of the underlying resource. This parameter also determines which _SRV to use in the union below. + + The resource type of the view. See D3D11_SRV_DIMENSION. You must set ViewDimension to the same resource type as that of the underlying resource. This parameter also determines which _SRV to use in the union below. + - View the resource as a buffer using information from a shader-resource view (see D3D11_BUFFER_SRV). + + View the resource as a buffer using information from a shader-resource view (see D3D11_BUFFER_SRV). + - View the resource as a 1D texture using information from a shader-resource view (see D3D11_TEX1D_SRV). + + View the resource as a 1D texture using information from a shader-resource view (see D3D11_TEX1D_SRV). + - View the resource as a 1D-texture array using information from a shader-resource view (see D3D11_TEX1D_ARRAY_SRV). + + View the resource as a 1D-texture array using information from a shader-resource view (see D3D11_TEX1D_ARRAY_SRV). + - View the resource as a 2D-texture using information from a shader-resource view (see D3D11_TEX2D_SRV). + + View the resource as a 2D-texture using information from a shader-resource view (see D3D11_TEX2D_SRV). + - View the resource as a 2D-texture array using information from a shader-resource view (see D3D11_TEX2D_ARRAY_SRV). + + View the resource as a 2D-texture array using information from a shader-resource view (see D3D11_TEX2D_ARRAY_SRV). + - View the resource as a 2D-multisampled texture using information from a shader-resource view (see D3D11_TEX2DMS_SRV). + + View the resource as a 2D-multisampled texture using information from a shader-resource view (see D3D11_TEX2DMS_SRV). + - View the resource as a 2D-multisampled-texture array using information from a shader-resource view (see D3D11_TEX2DMS_ARRAY_SRV). + + View the resource as a 2D-multisampled-texture array using information from a shader-resource view (see D3D11_TEX2DMS_ARRAY_SRV). + - View the resource as a 3D texture using information from a shader-resource view (see D3D11_TEX3D_SRV). + + View the resource as a 3D texture using information from a shader-resource view (see D3D11_TEX3D_SRV). + - View the resource as a 3D-cube texture using information from a shader-resource view (see D3D11_TEXCUBE_SRV). + + View the resource as a 3D-cube texture using information from a shader-resource view (see D3D11_TEXCUBE_SRV). + - View the resource as a 3D-cube-texture array using information from a shader-resource view (see D3D11_TEXCUBE_ARRAY_SRV). + + View the resource as a 3D-cube-texture array using information from a shader-resource view (see D3D11_TEXCUBE_ARRAY_SRV). + - View the resource as a raw buffer using information from a shader-resource view (see D3D11_BUFFEREX_SRV). For more info about raw viewing of buffers, see Raw Views of Buffers. + + View the resource as a raw buffer using information from a shader-resource view (see D3D11_BUFFEREX_SRV). For more info about raw viewing of buffers, see Raw Views of Buffers. + Describes Direct3D 9 feature options in the current graphics driver. - Microsoft Docs: + + Microsoft Docs: + - Specifies whether the driver supports the nonpowers-of-2-unconditionally feature. For more info about this feature, see feature level. The runtime sets this member to TRUE for hardware at Direct3D 10 and higher feature levels. For hardware at Direct3D 9.3 and lower feature levels, the runtime sets this member to FALSE if the hardware and driver support the powers-of-2 (2D textures must have widths and heights specified as powers of two) feature or the nonpowers-of-2-conditionally feature. + + Specifies whether the driver supports the nonpowers-of-2-unconditionally feature. For more info about this feature, see feature level. The runtime sets this member to TRUE for hardware at Direct3D 10 and higher feature levels. For hardware at Direct3D 9.3 and lower feature levels, the runtime sets this member to FALSE if the hardware and driver support the powers-of-2 (2D textures must have widths and heights specified as powers of two) feature or the nonpowers-of-2-conditionally feature. + - Specifies whether the driver supports the shadowing feature with the comparison-filtering mode set to less than or equal to. The runtime sets this member to TRUE for hardware at Direct3D 10 and higher feature levels. For hardware at Direct3D 9.3 and lower feature levels, the runtime sets this member to TRUE only if the hardware and driver support the shadowing feature; otherwise FALSE. + + Specifies whether the driver supports the shadowing feature with the comparison-filtering mode set to less than or equal to. The runtime sets this member to TRUE for hardware at Direct3D 10 and higher feature levels. For hardware at Direct3D 9.3 and lower feature levels, the runtime sets this member to TRUE only if the hardware and driver support the shadowing feature; otherwise FALSE. + - Specifies whether the hardware and driver support simple instancing. The runtime sets this member to TRUE if the hardware and driver support simple instancing. + + Specifies whether the hardware and driver support simple instancing. The runtime sets this member to TRUE if the hardware and driver support simple instancing. + - Specifies whether the hardware and driver support setting a single face of a TextureCube as a render target while the depth stencil surface that is bound alongside can be a Texture2D (as opposed to TextureCube). The runtime sets this member to TRUE if the hardware and driver support this feature; otherwise FALSE. + + Specifies whether the hardware and driver support setting a single face of a TextureCube as a render target while the depth stencil surface that is bound alongside can be a Texture2D (as opposed to TextureCube). The runtime sets this member to TRUE if the hardware and driver support this feature; otherwise FALSE. -If the hardware and driver don't support this feature, the app must match the render target surface type with the depth stencil surface type. Because hardware at Direct3D 9.3 and lower feature levels doesn't allow TextureCube depth surfaces, the only way to render a scene into a TextureCube while having depth buffering enabled is to render each TextureCube face separately to a Texture2D render target first (because that can be matched with a Texture2D depth), and then copy the results into the TextureCube. If the hardware and driver support this feature, the app can just render to the TextureCube faces directly while getting depth buffering out of a Texture2D depth buffer. + If the hardware and driver don't support this feature, the app must match the render target surface type with the depth stencil surface type. Because hardware at Direct3D 9.3 and lower feature levels doesn't allow TextureCube depth surfaces, the only way to render a scene into a TextureCube while having depth buffering enabled is to render each TextureCube face separately to a Texture2D render target first (because that can be matched with a Texture2D depth), and then copy the results into the TextureCube. If the hardware and driver support this feature, the app can just render to the TextureCube faces directly while getting depth buffering out of a Texture2D depth buffer. -You only need to query this feature from hardware at Direct3D 9.3 and lower feature levels because hardware at Direct3D 10.0 and higher feature levels allow TextureCube depth surfaces. + You only need to query this feature from hardware at Direct3D 9.3 and lower feature levels because hardware at Direct3D 10.0 and higher feature levels allow TextureCube depth surfaces. + Get the geometry shader resources. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin getting shader resources from (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). The number of resources to get from the device. Up to a maximum of 128 slots are available for shader resources (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to be returned by the device. + + Array of shader resource view interfaces to be returned by the device. + Set an array of sampler states to the compute-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting samplers to (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - 1). Number of samplers in the array. Each pipeline stage has a total of 16 sampler slots available (ranges from 0 to D3D11_COMMONSHADER_SAMPLER_SLOT_COUNT - StartSlot). - Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + + Pointer to an array of sampler-state interfaces (see ID3D11SamplerState). See Remarks. + Sets the constant buffers used by the pixel shader pipeline stage. - Microsoft Docs: - Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). - Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffers (see ID3D11Buffer) being given to the device. + + Microsoft Docs: + + + Index into the device's zero-based array to begin setting constant buffers to (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). + + + Number of buffers to set (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). + + + Array of constant buffers (see ID3D11Buffer) being given to the device. + Bind an array of shader resources to the hull-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting shader resources to (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). Number of shader resources to set. Up to a maximum of 128 slots are available for shader resources(ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to set to the device. + + Array of shader resource view interfaces to set to the device. + Flags for indicating a subset of components used with video decode histogram. - Microsoft Docs: + + Microsoft Docs: + @@ -12385,7 +17273,9 @@ You only need to query this feature from hardware at Direct3D 9.3 and lower Specifies the rate at which the video processor produces output frames from an input stream. - Microsoft Docs: + + Microsoft Docs: + @@ -12400,21 +17290,29 @@ You only need to query this feature from hardware at Direct3D 9.3 and lower This shader-reflection interface provides access to variable type. - Microsoft Docs: + + Microsoft Docs: + Get a patch-constant parameter description for a shader. - Microsoft Docs: + + Microsoft Docs: + A zero-based parameter index. - A pointer to a shader-input-signature description. See D3D11_SIGNATURE_PARAMETER_DESC. + + A pointer to a shader-input-signature description. See D3D11_SIGNATURE_PARAMETER_DESC. + Contains a Message Authentication Code (MAC). - Microsoft Docs: + + Microsoft Docs: + @@ -12423,19 +17321,25 @@ You only need to query this feature from hardware at Direct3D 9.3 and lower The blend-state interface holds a description for blending state that you can bind to the output-merger stage. This blend-state interface supports logical operations as well as blending operations. - Microsoft Docs: + + Microsoft Docs: + Enumerates the video processor capabilities of a Microsoft Direct3D 11 device. - Microsoft Docs: + + Microsoft Docs: + Rebinds a resource as an unordered access view (UAV) from source slot to destination slot. - Microsoft Docs: + + Microsoft Docs: + The first source slot number for rebinding. The first destination slot number for rebinding. The number of slots for rebinding. @@ -12444,13 +17348,17 @@ You only need to query this feature from hardware at Direct3D 9.3 and lower A library-reflection interface accesses library info. - Microsoft Docs: + + Microsoft Docs: + Debug message severity levels for an information queue. - Microsoft Docs: + + Microsoft Docs: + @@ -12466,31 +17374,45 @@ You only need to query this feature from hardware at Direct3D 9.3 and lower Defines an information message. - Defines a message other than corruption, error, warning, or information. + + Defines a message other than corruption, error, warning, or information. -Direct3D 11:  This value is not supported until Direct3D 11.1. + Direct3D 11:  This value is not supported until Direct3D 11.1. + Allows applications to annotate the beginning of a range of graphics commands. - Microsoft Docs: - An optional string that will be logged to ETW when ETW logging is active. If ‘#d’ appears in the string, it will be replaced by the value of the Data parameter similar to the way printf works. + + Microsoft Docs: + + + An optional string that will be logged to ETW when ETW logging is active. If ‘#d’ appears in the string, it will be replaced by the value of the Data parameter similar to the way printf works. + A signed data value that will be logged to ETW when ETW logging is active. Gets a random number that can be used to refresh the session key. - Microsoft Docs: - A pointer to the ID3D11CryptoSession interface. - The size of the pRandomNumber array, in bytes. The size should match the size of the session key. + + Microsoft Docs: + + + A pointer to the ID3D11CryptoSession interface. + + + The size of the pRandomNumber array, in bytes. The size should match the size of the session key. + A pointer to a byte array that receives a random number. RGB or alpha blending operation. - Microsoft Docs: + + Microsoft Docs: + @@ -12511,81 +17433,125 @@ You only need to query this feature from hardware at Direct3D 9.3 and lower Specifies the types of CPU access allowed for a resource. - Microsoft Docs: + + Microsoft Docs: + - The resource is to be mappable so that the CPU can change its contents. Resources created with this flag cannot be set as outputs of the pipeline and must be created with either dynamic or staging usage (see D3D11_USAGE). + + The resource is to be mappable so that the CPU can change its contents. Resources created with this flag cannot be set as outputs of the pipeline and must be created with either dynamic or staging usage (see D3D11_USAGE). + - The resource is to be mappable so that the CPU can read its contents. Resources created with this flag cannot be set as either inputs or outputs to the pipeline and must be created with staging usage (see D3D11_USAGE). + + The resource is to be mappable so that the CPU can read its contents. Resources created with this flag cannot be set as either inputs or outputs to the pipeline and must be created with staging usage (see D3D11_USAGE). + Get the constant buffers used by the hull-shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin retrieving constant buffers from (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - 1). Number of buffers to retrieve (ranges from 0 to D3D11_COMMONSHADER_CONSTANT_BUFFER_API_SLOT_COUNT - StartSlot). - Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + + Array of constant buffer interface pointers (see ID3D11Buffer) to be returned by the method. + Updates mappings of tile locations in tiled resources to memory locations in a tile pool. - Microsoft Docs: + + Microsoft Docs: + A pointer to the tiled resource. The number of tiled resource regions. - An array of D3D11_TILED_RESOURCE_COORDINATE structures that describe the starting coordinates of the tiled resource regions. The NumTiledResourceRegions parameter specifies the number of D3D11_TILED_RESOURCE_COORDINATE structures in the array. - An array of D3D11_TILE_REGION_SIZE structures that describe the sizes of the tiled resource regions. The NumTiledResourceRegions parameter specifies the number of D3D11_TILE_REGION_SIZE structures in the array. + + An array of D3D11_TILED_RESOURCE_COORDINATE structures that describe the starting coordinates of the tiled resource regions. The NumTiledResourceRegions parameter specifies the number of D3D11_TILED_RESOURCE_COORDINATE structures in the array. + + + An array of D3D11_TILE_REGION_SIZE structures that describe the sizes of the tiled resource regions. The NumTiledResourceRegions parameter specifies the number of D3D11_TILE_REGION_SIZE structures in the array. + A pointer to the tile pool. The number of tile-pool ranges. - An array of D3D11_TILE_RANGE_FLAG values that describe each tile-pool range. The NumRanges parameter specifies the number of values in the array. + + An array of D3D11_TILE_RANGE_FLAG values that describe each tile-pool range. The NumRanges parameter specifies the number of values in the array. + An array of offsets into the tile pool. These are 0-based tile offsets, counting in tiles (not bytes). - An array of tiles. + + An array of tiles. -An array of values that specify the number of tiles in each tile-pool range. The NumRanges parameter specifies the number of values in the array. - A combination of D3D11_TILE_MAPPING_FLAGS values that are combined by using a bitwise OR operation. + An array of values that specify the number of tiles in each tile-pool range. The NumRanges parameter specifies the number of values in the array. + + + A combination of D3D11_TILE_MAPPING_FLAGS values that are combined by using a bitwise OR operation. + Gets a list of custom frame rates that a video processor supports. - Microsoft Docs: - The zero-based index of the frame-rate capability group. To get the maxmum index, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the RateConversionCapsCount member of the D3D11_VIDEO_PROCESSOR_CAPS structure. - The zero-based index of the custom rate to retrieve. To get the maximum index, call ID3D11VideoProcessorEnumerator::GetVideoProcessorRateConversionCaps and check the CustomRateCount member of the D3D11_VIDEO_PROCESSOR_RATE_CONVERSION_CAPS structure. + + Microsoft Docs: + + + The zero-based index of the frame-rate capability group. To get the maxmum index, call ID3D11VideoProcessorEnumerator::GetVideoProcessorCaps and check the RateConversionCapsCount member of the D3D11_VIDEO_PROCESSOR_CAPS structure. + + + The zero-based index of the custom rate to retrieve. To get the maximum index, call ID3D11VideoProcessorEnumerator::GetVideoProcessorRateConversionCaps and check the CustomRateCount member of the D3D11_VIDEO_PROCESSOR_RATE_CONVERSION_CAPS structure. -This index value is always relative to the capability group specified in the TypeIndex parameter. - A pointer to a D3D11_VIDEO_PROCESSOR_CUSTOM_RATE structure that receives the custom rate. + This index value is always relative to the capability group specified in the TypeIndex parameter. + + + A pointer to a D3D11_VIDEO_PROCESSOR_CUSTOM_RATE structure that receives the custom rate. + The blend-state interface holds a description for blending state that you can bind to the output-merger stage. - Microsoft Docs: + + Microsoft Docs: + Describes a video processor input view. - Microsoft Docs: + + Microsoft Docs: + The surface format. If zero, the driver uses the DXGI format that was used to create the resource. If you are using feature level 9, the value must be zero. - The resource type of the view, specified as a member of the D3D11_VPIV_DIMENSION enumeration. + + The resource type of the view, specified as a member of the D3D11_VPIV_DIMENSION enumeration. + - A D3D11_TEX2D_VPIV structure that identifies the texture resource. + + A D3D11_TEX2D_VPIV structure that identifies the texture resource. + Bind an array of vertex buffers to the input-assembler stage. - Microsoft Docs: - The first input slot for binding. The first vertex buffer is explicitly bound to the start slot; this causes each additional vertex buffer in the array to be implicitly bound to each subsequent input slot. The maximum of 16 or 32 input slots (ranges from 0 to D3D11_IA_VERTEX_INPUT_RESOURCE_SLOT_COUNT - 1) are available; the maximum number of input slots depends on the feature level. + + Microsoft Docs: + + + The first input slot for binding. The first vertex buffer is explicitly bound to the start slot; this causes each additional vertex buffer in the array to be implicitly bound to each subsequent input slot. The maximum of 16 or 32 input slots (ranges from 0 to D3D11_IA_VERTEX_INPUT_RESOURCE_SLOT_COUNT - 1) are available; the maximum number of input slots depends on the feature level. + The number of vertex buffers in the array. The number of buffers (plus the starting slot) can't exceed the total number of IA-stage input slots (ranges from 0 to D3D11_IA_VERTEX_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - A pointer to an array of vertex buffers (see ID3D11Buffer). The vertex buffers must have been created with the D3D11_BIND_VERTEX_BUFFER flag. + + A pointer to an array of vertex buffers (see ID3D11Buffer). The vertex buffers must have been created with the D3D11_BIND_VERTEX_BUFFER flag. + Pointer to an array of stride values; one stride value for each buffer in the vertex-buffer array. Each stride is the size (in bytes) of the elements that are to be used from that vertex buffer. Pointer to an array of offset values; one offset value for each buffer in the vertex-buffer array. Each offset is the number of bytes between the first element of a vertex buffer and the first element that will be used. @@ -12593,123 +17559,183 @@ This index value is always relative to the capability group specified in the Submits one or more buffers for decoding. - Microsoft Docs: - A pointer to the ID3D11VideoDecoder interface. To get this pointer, call the ID3D11VideoDevice::CreateVideoDecoder method. + + Microsoft Docs: + + + A pointer to the ID3D11VideoDecoder interface. To get this pointer, call the ID3D11VideoDevice::CreateVideoDecoder method. + The number of buffers submitted for decoding. - A pointer to an array of D3D11_VIDEO_DECODER_BUFFER_DESC1 structures. The NumBuffers parameter specifies the number of elements in the array. Each element in the array describes a compressed buffer for decoding. + + A pointer to an array of D3D11_VIDEO_DECODER_BUFFER_DESC1 structures. The NumBuffers parameter specifies the number of elements in the array. Each element in the array describes a compressed buffer for decoding. + Describes a query. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_QUERY-typed value that specifies the type of query. + + A D3D11_QUERY-typed value that specifies the type of query. + - A combination of D3D11_QUERY_MISC_FLAG-typed values that are combined by using a bitwise OR operation. The resulting value specifies query behavior. + + A combination of D3D11_QUERY_MISC_FLAG-typed values that are combined by using a bitwise OR operation. The resulting value specifies query behavior. + - A D3D11_CONTEXT_TYPE-typed value that specifies the context for the query. + + A D3D11_CONTEXT_TYPE-typed value that specifies the context for the query. + An ID3D11ShaderTraceFactory interface implements a method for generating shader trace information objects. - Microsoft Docs: + + Microsoft Docs: + Get a constant-buffer description. - Microsoft Docs: - A pointer to a D3D11_SHADER_BUFFER_DESC, which represents a shader-buffer description. + + Microsoft Docs: + + + A pointer to a D3D11_SHADER_BUFFER_DESC, which represents a shader-buffer description. + Bind an array of shader resources to the geometry shader stage. - Microsoft Docs: + + Microsoft Docs: + Index into the device's zero-based array to begin setting shader resources to (ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - 1). Number of shader resources to set. Up to a maximum of 128 slots are available for shader resources(ranges from 0 to D3D11_COMMONSHADER_INPUT_RESOURCE_SLOT_COUNT - StartSlot). - Array of shader resource view interfaces to set to the device. + + Array of shader resource view interfaces to set to the device. + Describes rasterizer state. - Microsoft Docs: + + Microsoft Docs: + - A D3D11_FILL_MODE-typed value that determines the fill mode to use when rendering. + + A D3D11_FILL_MODE-typed value that determines the fill mode to use when rendering. + - A D3D11_CULL_MODE-typed value that indicates that triangles facing the specified direction are not drawn. + + A D3D11_CULL_MODE-typed value that indicates that triangles facing the specified direction are not drawn. + - Specifies whether a triangle is front- or back-facing. If TRUE, a triangle will be considered front-facing if its vertices are counter-clockwise on the render target and considered back-facing if they are clockwise. If FALSE, the opposite is true. + + Specifies whether a triangle is front- or back-facing. If TRUE, a triangle will be considered front-facing if its vertices are counter-clockwise on the render target and considered back-facing if they are clockwise. If FALSE, the opposite is true. + - Depth value added to a given pixel. For info about depth bias, see Depth Bias. + + Depth value added to a given pixel. For info about depth bias, see Depth Bias. + - Maximum depth bias of a pixel. For info about depth bias, see Depth Bias. + + Maximum depth bias of a pixel. For info about depth bias, see Depth Bias. + - Scalar on a given pixel's slope. For info about depth bias, see Depth Bias. + + Scalar on a given pixel's slope. For info about depth bias, see Depth Bias. + - Specifies whether to enable clipping based on distance. + + Specifies whether to enable clipping based on distance. -The hardware always performs x and y clipping of rasterized coordinates. When DepthClipEnable is set to the default–TRUE, the hardware also clips the z value (that is, the hardware performs the last step of the following algorithm). + The hardware always performs x and y clipping of rasterized coordinates. When DepthClipEnable is set to the default–TRUE, the hardware also clips the z value (that is, the hardware performs the last step of the following algorithm). -

+      

 0 < w
 -w <= x <= w (or arbitrarily wider range if implementation uses a guard band to reduce clipping burden)
 -w <= y <= w (or arbitrarily wider range if implementation uses a guard band to reduce clipping burden)
 0 <= z <= w
 

-When you set DepthClipEnable to FALSE, the hardware skips the z clipping (that is, the last step in the preceding algorithm). However, the hardware still performs the "0 < w" clipping. When z clipping is disabled, improper depth ordering at the pixel level might result. However, when z clipping is disabled, stencil shadow implementations are simplified. In other words, you can avoid complex special-case handling for geometry that goes beyond the back clipping plane.
 + When you set DepthClipEnable to FALSE, the hardware skips the z clipping (that is, the last step in the preceding algorithm). However, the hardware still performs the "0 < w" clipping. When z clipping is disabled, improper depth ordering at the pixel level might result. However, when z clipping is disabled, stencil shadow implementations are simplified. In other words, you can avoid complex special-case handling for geometry that goes beyond the back clipping plane. + Specifies whether to enable scissor-rectangle culling. All pixels outside an active scissor rectangle are culled. - Specifies whether to use the quadrilateral or alpha line anti-aliasing algorithm on multisample antialiasing (MSAA) render targets. Set to TRUE to use the quadrilateral line anti-aliasing algorithm and to FALSE to use the alpha line anti-aliasing algorithm. For more info about this member, see Remarks. + + Specifies whether to use the quadrilateral or alpha line anti-aliasing algorithm on multisample antialiasing (MSAA) render targets. Set to TRUE to use the quadrilateral line anti-aliasing algorithm and to FALSE to use the alpha line anti-aliasing algorithm. For more info about this member, see Remarks. + - Specifies whether to enable line antialiasing; only applies if doing line drawing and MultisampleEnable is FALSE. For more info about this member, see Remarks. + + Specifies whether to enable line antialiasing; only applies if doing line drawing and MultisampleEnable is FALSE. For more info about this member, see Remarks. + - The sample count that is forced while UAV rendering or rasterizing. Valid values are 0, 1, 2, 4, 8, and optionally 16. 0 indicates that the sample count is not forced. + + The sample count that is forced while UAV rendering or rasterizing. Valid values are 0, 1, 2, 4, 8, and optionally 16. 0 indicates that the sample count is not forced. -
Note  If you want to render with ForcedSampleCount set to 1 or greater, you must follow these guidelines: +
+ Note  If you want to render with ForcedSampleCount set to 1 or greater, you must follow these guidelines: -
    -
  • Don't bind depth-stencil views.
    • -
  • Disable depth testing.
    • -
  • Ensure the shader doesn't output depth.
    • -
  • If you have any render-target views bound (D3D11_BIND_RENDER_TARGET) and ForcedSampleCount is greater than 1, ensure that every render target has only a single sample.
    • -
  • Don't operate the shader at sample frequency. Therefore, ID3D11ShaderReflection::IsSampleFrequencyShader returns FALSE.
    • -
Otherwise, rendering behavior is undefined. For info about how to configure depth-stencil, see Configuring Depth-Stencil Functionality.
-
 
 +
    +
  • Don't bind depth-stencil views.
    • +
  • Disable depth testing.
    • +
  • Ensure the shader doesn't output depth.
    • +
  • + If you have any render-target views bound (D3D11_BIND_RENDER_TARGET) and ForcedSampleCount is greater than 1, ensure that every render target has only a single sample. +
    • +
  • + Don't operate the shader at sample frequency. Therefore, ID3D11ShaderReflection::IsSampleFrequencyShader returns FALSE. +
    • +
Otherwise, rendering behavior is undefined. For info about how to configure depth-stencil, see Configuring Depth-Stencil Functionality. + +
 
+ - A D3D11_CONSERVATIVE_RASTERIZATION_MODE-typed value that identifies whether conservative rasterization is on or off. + + A D3D11_CONSERVATIVE_RASTERIZATION_MODE-typed value that identifies whether conservative rasterization is on or off. + Get a message category to break on when a message with that category passes through the storage filter. - Microsoft Docs: - Message category to break on (see D3D11_MESSAGE_CATEGORY). + + Microsoft Docs: + + + Message category to break on (see D3D11_MESSAGE_CATEGORY). + Identifies the type of geometry shader input primitive. - Microsoft Docs: + + Microsoft Docs: + @@ -12733,21 +17759,29 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl The device context interface represents a device context; it is used to render commands. ID3D11DeviceContext3 adds new methods to those in ID3D11DeviceContext2. - Microsoft Docs: + + Microsoft Docs: + Set a message severity level to break on when a message with that severity level passes through the storage filter. - Microsoft Docs: - A D3D11_MESSAGE_SEVERITY, which represents a message severity level to break on. + + Microsoft Docs: + + + A D3D11_MESSAGE_SEVERITY, which represents a message severity level to break on. + Turns this breaking condition on or off (true for on, false for off). Rebinds an unordered access view (UAV) by name to destination slots. - Microsoft Docs: + + Microsoft Docs: + The name of the UAV for rebinding. The first destination slot number for rebinding. The number of slots for rebinding. @@ -12756,7 +17790,9 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl Describes rasterizer state. - Microsoft Docs: + + Microsoft Docs: + @@ -12766,60 +17802,86 @@ When you set DepthClipEnable to FALSE, the hardware skips the z cl Indicates that triangles facing the specified direction are not drawn. - Specifies whether a triangle is front- or back-facing. If TRUE, a triangle will be considered front-facing if its vertices are counter-clockwise on the render target and considered back-facing if they are clockwise. If FALSE, the opposite is true. + + Specifies whether a triangle is front- or back-facing. If TRUE, a triangle will be considered front-facing if its vertices are counter-clockwise on the render target and considered back-facing if they are clockwise. If FALSE, the opposite is true. + - Depth value added to a given pixel. For info about depth bias, see Depth Bias. + + Depth value added to a given pixel. For info about depth bias, see Depth Bias. + - Maximum depth bias of a pixel. For info about depth bias, see Depth Bias. + + Maximum depth bias of a pixel. For info about depth bias, see Depth Bias. + - Scalar on a given pixel's slope. For info about depth bias, see Depth Bias. + + Scalar on a given pixel's slope. For info about depth bias, see Depth Bias. + - Specifies whether to enable clipping based on distance. + + Specifies whether to enable clipping based on distance. -The hardware always performs x and y clipping of rasterized coordinates. When DepthClipEnable is set to the default–TRUE, the hardware also clips the z value (that is, the hardware performs the last step of the following algorithm). + The hardware always performs x and y clipping of rasterized coordinates. When DepthClipEnable is set to the default–TRUE, the hardware also clips the z value (that is, the hardware performs the last step of the following algorithm). -

+      

 0 < w
 -w <= x <= w (or arbitrarily wider range if implementation uses a guard band to reduce clipping burden)
 -w <= y <= w (or arbitrarily wider range if implementation uses a guard band to reduce clipping burden)
 0 <= z <= w
 

-When you set DepthClipEnable to FALSE, the hardware skips the z clipping (that is, the last step in the preceding algorithm). However, the hardware still performs the "0 < w" clipping. When z clipping is disabled, improper depth ordering at the pixel level might result. However, when z clipping is disabled, stencil shadow implementations are simplified. In other words, you can avoid complex special-case handling for geometry that goes beyond the back clipping plane.
 + When you set DepthClipEnable to FALSE, the hardware skips the z clipping (that is, the last step in the preceding algorithm). However, the hardware still performs the "0 < w" clipping. When z clipping is disabled, improper depth ordering at the pixel level might result. However, when z clipping is disabled, stencil shadow implementations are simplified. In other words, you can avoid complex special-case handling for geometry that goes beyond the back clipping plane. + Specifies whether to enable scissor-rectangle culling. All pixels outside an active scissor rectangle are culled. - Specifies whether to use the quadrilateral or alpha line anti-aliasing algorithm on multisample antialiasing (MSAA) render targets. Set to TRUE to use the quadrilateral line anti-aliasing algorithm and to FALSE to use the alpha line anti-aliasing algorithm. For more info about this member, see Remarks. + + Specifies whether to use the quadrilateral or alpha line anti-aliasing algorithm on multisample antialiasing (MSAA) render targets. Set to TRUE to use the quadrilateral line anti-aliasing algorithm and to FALSE to use the alpha line anti-aliasing algorithm. For more info about this member, see Remarks. + - Specifies whether to enable line antialiasing; only applies if doing line drawing and MultisampleEnable is FALSE. For more info about this member, see Remarks. + + Specifies whether to enable line antialiasing; only applies if doing line drawing and MultisampleEnable is FALSE. For more info about this member, see Remarks. + - The sample count that is forced while UAV rendering or rasterizing. Valid values are 0, 1, 2, 4, 8, and optionally 16. 0 indicates that the sample count is not forced. + + The sample count that is forced while UAV rendering or rasterizing. Valid values are 0, 1, 2, 4, 8, and optionally 16. 0 indicates that the sample count is not forced. -
Note  If you want to render with ForcedSampleCount set to 1 or greater, you must follow these guidelines: +
+ Note  If you want to render with ForcedSampleCount set to 1 or greater, you must follow these guidelines: -
    -
  • Don't bind depth-stencil views.
    • -
  • Disable depth testing.
    • -
  • Ensure the shader doesn't output depth.
    • -
  • If you have any render-target views bound (D3D11_BIND_RENDER_TARGET) and ForcedSampleCount is greater than 1, ensure that every render target has only a single sample.
    • -
  • Don't operate the shader at sample frequency. Therefore, ID3D11ShaderReflection::IsSampleFrequencyShader returns FALSE.
    • -
Otherwise, rendering behavior is undefined. For info about how to configure depth-stencil, see Configuring Depth-Stencil Functionality.
-
 
 +
    +
  • Don't bind depth-stencil views.
    • +
  • Disable depth testing.
    • +
  • Ensure the shader doesn't output depth.
    • +
  • + If you have any render-target views bound (D3D11_BIND_RENDER_TARGET) and ForcedSampleCount is greater than 1, ensure that every render target has only a single sample. +
    • +
  • + Don't operate the shader at sample frequency. Therefore, ID3D11ShaderReflection::IsSampleFrequencyShader returns FALSE. +
    • +
Otherwise, rendering behavior is undefined. For info about how to configure depth-stencil, see Configuring Depth-Stencil Functionality. + +
 
+ Add a user-defined message to the message queue and send that message to debug output. - Microsoft Docs: - Severity of a message (see D3D11_MESSAGE_SEVERITY). + + Microsoft Docs: + + + Severity of a message (see D3D11_MESSAGE_SEVERITY). + Message string. - \ No newline at end of file + diff --git a/src/Vortice.Win32/Generated/Graphics/Direct3D11.cs b/src/Vortice.Win32/Generated/Graphics/Direct3D11.cs index b185226..025897b 100644 --- a/src/Vortice.Win32/Generated/Graphics/Direct3D11.cs +++ b/src/Vortice.Win32/Generated/Graphics/Direct3D11.cs @@ -1051,7 +1051,7 @@ public enum BufferExtendedSrvFlag : int /// /// D3D11_DSV_FLAG [Flags] -public enum DsvFlag : int +public enum DsvFlags : int { None = 0, /// @@ -8352,7 +8352,7 @@ public partial struct DepthStencilViewDescription public DsvDimension ViewDimension; /// - public uint Flags; + public DsvFlags Flags; /// public _Anonymous_e__Union Anonymous; diff --git a/src/Vortice.Win32/Graphics/Direct3D11.Manual.cs b/src/Vortice.Win32/Graphics/Direct3D11.Manual.cs index dd2e729..e35d9f2 100644 --- a/src/Vortice.Win32/Graphics/Direct3D11.Manual.cs +++ b/src/Vortice.Win32/Graphics/Direct3D11.Manual.cs @@ -4,7 +4,8 @@ using System.Runtime.CompilerServices; using Win32.Graphics.Direct3D; using Win32.Graphics.Dxgi; -using static Win32.Graphics.Dxgi.Apis; +using Win32.Graphics.Dxgi.Common; +using static Win32.Graphics.Direct3D11.Apis; using static Win32.StringUtilities; namespace Win32.Graphics.Direct3D11; @@ -58,6 +59,7 @@ public partial struct AuthenticatedProtectionFlags } } + public static unsafe partial class Apis { public static HResult D3D11CreateDevice( diff --git a/src/Vortice.Win32/Graphics/Direct3D11/DepthStencilViewDescription.cs b/src/Vortice.Win32/Graphics/Direct3D11/DepthStencilViewDescription.cs new file mode 100644 index 0000000..4abd010 --- /dev/null +++ b/src/Vortice.Win32/Graphics/Direct3D11/DepthStencilViewDescription.cs @@ -0,0 +1,168 @@ +// Copyright © Amer Koleci and Contributors. +// Licensed under the MIT License (MIT). See LICENSE in the repository root for more information. + +using Win32.Graphics.Dxgi.Common; + +namespace Win32.Graphics.Direct3D11; + +public unsafe partial struct DepthStencilViewDescription +{ + /// + /// Initializes a new instance of the struct. + /// + /// The + /// The to use or . + /// The index of the mipmap level to use mip slice. + /// The index of the first texture to use in an array of textures. + /// Number of textures in the array. + /// + public DepthStencilViewDescription( + DsvDimension viewDimension, + Format format = Format.Unknown, + uint mipSlice = 0, + uint firstArraySlice = 0, + uint arraySize = unchecked((uint)-1), + DsvFlags flags = DsvFlags.None) + { + Format = format; + ViewDimension = viewDimension; + Flags = flags; + Anonymous = default; + + switch (viewDimension) + { + case DsvDimension.Texture1D: + Anonymous.Texture1D.MipSlice = mipSlice; + break; + case DsvDimension.Texture1DArray: + Anonymous.Texture1DArray.MipSlice = mipSlice; + Anonymous.Texture1DArray.FirstArraySlice = firstArraySlice; + Anonymous.Texture1DArray.ArraySize = arraySize; + break; + case DsvDimension.Texture2D: + Anonymous.Texture2D.MipSlice = mipSlice; + break; + case DsvDimension.Texture2DArray: + Anonymous.Texture2DArray.MipSlice = mipSlice; + Anonymous.Texture2DArray.FirstArraySlice = firstArraySlice; + Anonymous.Texture2DArray.ArraySize = arraySize; + break; + case DsvDimension.Texture2DMs: + break; + case DsvDimension.Texture2DMsArray: + Anonymous.Texture2DMSArray.FirstArraySlice = firstArraySlice; + Anonymous.Texture2DMSArray.ArraySize = arraySize; + break; + default: + break; + } + } + + /// + /// Initializes a new instance of the struct. + /// + /// + /// + /// + /// + /// + /// + /// + public DepthStencilViewDescription( + ID3D11Texture1D* texture, + bool isArray, + Format format = Format.Unknown, + uint mipSlice = 0, + uint firstArraySlice = 0, + uint arraySize = unchecked((uint)-1), + DsvFlags flags = DsvFlags.None) + { + ViewDimension = isArray ? DsvDimension.Texture1DArray : DsvDimension.Texture1D; + Flags = flags; + Anonymous = default; + + if (format == Format.Unknown + || (arraySize == unchecked((uint)-1) && DsvDimension.Texture1DArray == ViewDimension)) + { + Texture1DDescription textureDesc; + texture->GetDesc(&textureDesc); + + if (format == Format.Unknown) + format = textureDesc.Format; + if (arraySize == unchecked((uint)-1)) + arraySize = textureDesc.ArraySize - firstArraySlice; + } + + Format = format; + switch (ViewDimension) + { + case DsvDimension.Texture1D: + Anonymous.Texture1D.MipSlice = mipSlice; + break; + case DsvDimension.Texture1DArray: + Anonymous.Texture1DArray.MipSlice = mipSlice; + Anonymous.Texture1DArray.FirstArraySlice = firstArraySlice; + Anonymous.Texture1DArray.ArraySize = arraySize; + break; + default: + break; + } + } + + /// + /// Initializes a new instance of the struct. + /// + /// + /// + /// + /// + /// + /// + /// + public DepthStencilViewDescription( + ID3D11Texture2D* texture, + DsvDimension viewDimension, + Format format = Format.Unknown, + uint mipSlice = 0, + uint firstArraySlice = 0, + uint arraySize = unchecked((uint)-1), + DsvFlags flags = DsvFlags.None) + { + ViewDimension = viewDimension; + Flags = flags; + Anonymous = default; + + if (format == Format.Unknown + || (arraySize == unchecked((uint)-1) && (DsvDimension.Texture2DArray == viewDimension || DsvDimension.Texture2DMsArray == viewDimension))) + { + Texture2DDescription textureDesc; + texture->GetDesc(&textureDesc); + + if (format == Format.Unknown) + format = textureDesc.Format; + if (arraySize == unchecked((uint)-1)) + arraySize = textureDesc.ArraySize - firstArraySlice; + } + + Format = format; + switch (viewDimension) + { + case DsvDimension.Texture2D: + Anonymous.Texture2D.MipSlice = mipSlice; + break; + case DsvDimension.Texture2DArray: + Anonymous.Texture2DArray.MipSlice = mipSlice; + Anonymous.Texture2DArray.FirstArraySlice = firstArraySlice; + Anonymous.Texture2DArray.ArraySize = arraySize; + break; + case DsvDimension.Texture2DMs: + break; + case DsvDimension.Texture2DMsArray: + Anonymous.Texture2DMSArray.FirstArraySlice = firstArraySlice; + Anonymous.Texture2DMSArray.ArraySize = arraySize; + break; + default: + break; + } + } +} diff --git a/src/Vortice.Win32/Graphics/Direct3D11/ID3D11DeviceExtensions.cs b/src/Vortice.Win32/Graphics/Direct3D11/ID3D11DeviceExtensions.cs new file mode 100644 index 0000000..777a5e3 --- /dev/null +++ b/src/Vortice.Win32/Graphics/Direct3D11/ID3D11DeviceExtensions.cs @@ -0,0 +1,95 @@ +// Copyright © Amer Koleci and Contributors. +// Licensed under the MIT License (MIT). See LICENSE in the repository root for more information. + +namespace Win32.Graphics.Direct3D11; + +/// +/// A with extensions for the type. +/// +public static unsafe class ID3D11DeviceExtensions +{ + public static ComPtr CreateBuffer( + this ref ID3D11Device device, + in T data, + BufferDescription description) where T : unmanaged + { + if (description.ByteWidth == 0) + description.ByteWidth = (uint)sizeof(T); + + fixed (T* dataPtr = &data) + { + SubresourceData subresourceData = new() + { + pSysMem = dataPtr + }; + + using ComPtr buffer = default; + device.CreateBuffer(&description, &subresourceData, buffer.GetAddressOf()).ThrowIfFailed(); + return buffer.Move(); + } + } + + public static ComPtr CreateBuffer(this ref ID3D11Device device, ReadOnlySpan data, BufferDescription description) where T : unmanaged + { + if (description.ByteWidth == 0) + description.ByteWidth = (uint)(sizeof(T) * data.Length); + + fixed (T* dataPtr = data) + { + SubresourceData subresourceData = new() + { + pSysMem = dataPtr + }; + + using ComPtr buffer = default; + device.CreateBuffer(&description, &subresourceData, buffer.GetAddressOf()).ThrowIfFailed(); + return buffer.Move(); + } + } + + /// + /// Creates a new instance of the class. + /// + /// Type of the data to upload + /// The instance. + /// Flags specifying how the buffer will be bound to the pipeline. + /// Initial data used to initialize the buffer. + /// The size, in bytes, of the buffer. If 0 is specified, sizeof(T) * data.Length is used. + /// The usage pattern for the buffer. + /// Flags specifying how the buffer will be accessible from the CPU. + /// Miscellaneous resource options. + /// The size (in bytes) of the structure element for structured buffers. + /// An initialized buffer + public static ComPtr CreateBuffer( + this ref ID3D11Device device, + ReadOnlySpan data, + BindFlags bindFlags, + Usage usage = Usage.Default, + CpuAccessFlags accessFlags = CpuAccessFlags.None, + ResourceMiscFlags miscFlags = ResourceMiscFlags.None, + uint sizeInBytes = 0, + uint structureByteStride = 0) where T : unmanaged + { + BufferDescription description = new() + { + ByteWidth = sizeInBytes == 0 ? (uint)(sizeof(T) * data.Length) : sizeInBytes, + BindFlags = bindFlags, + CPUAccessFlags = accessFlags, + MiscFlags = miscFlags, + Usage = usage, + StructureByteStride = structureByteStride == 0 ? (uint)sizeof(T) : structureByteStride, + }; + + fixed (T* dataPtr = data) + { + SubresourceData subresourceData = new() + { + pSysMem = dataPtr + }; + + using ComPtr buffer = default; + device.CreateBuffer(&description, &subresourceData, buffer.GetAddressOf()).ThrowIfFailed(); + return buffer.Move(); + } + } +} diff --git a/src/Vortice.Win32/Graphics/Direct3D11/RenderTargetViewDescription.cs b/src/Vortice.Win32/Graphics/Direct3D11/RenderTargetViewDescription.cs new file mode 100644 index 0000000..f989a34 --- /dev/null +++ b/src/Vortice.Win32/Graphics/Direct3D11/RenderTargetViewDescription.cs @@ -0,0 +1,217 @@ +// Copyright © Amer Koleci and Contributors. +// Licensed under the MIT License (MIT). See LICENSE in the repository root for more information. + +using System.Xml.Serialization; +using Win32.Graphics.Dxgi.Common; + +namespace Win32.Graphics.Direct3D11; + +public unsafe partial struct RenderTargetViewDescription +{ + /// + /// Initializes a new instance of the struct. + /// + /// The + /// The to use or . + /// The index of the mipmap level to use mip slice. or first element for . + /// The index of the first texture to use in an array of textures or NumElements for , FirstWSlice for . + /// Number of textures in the array or WSize for . + public RenderTargetViewDescription( + RtvDimension viewDimension, + Format format = Format.Unknown, + uint mipSlice = 0, + uint firstArraySlice = 0, + uint arraySize = unchecked((uint)-1)) + { + Format = format; + ViewDimension = viewDimension; + Anonymous = default; + + switch (viewDimension) + { + case RtvDimension.Buffer: + Buffer.FirstElement = mipSlice; + Buffer.NumElements = firstArraySlice; + break; + case RtvDimension.Texture1D: + Texture1D.MipSlice = mipSlice; + break; + case RtvDimension.Texture1DArray: + Texture1DArray.MipSlice = mipSlice; + Texture1DArray.FirstArraySlice = firstArraySlice; + Texture1DArray.ArraySize = arraySize; + break; + case RtvDimension.Texture2D: + Texture2D.MipSlice = mipSlice; + break; + case RtvDimension.Texture2DArray: + Texture2DArray.MipSlice = mipSlice; + Texture2DArray.FirstArraySlice = firstArraySlice; + Texture2DArray.ArraySize = arraySize; + break; + case RtvDimension.Texture2DMs: + break; + case RtvDimension.Texture2DMsArray: + Texture2DMSArray.FirstArraySlice = firstArraySlice; + Texture2DMSArray.ArraySize = arraySize; + break; + case RtvDimension.Texture3D: + Texture3D.MipSlice = mipSlice; + Texture3D.FirstWSlice = firstArraySlice; + Texture3D.WSize = arraySize; + break; + default: + break; + } + } + + /// + /// Initializes a new instance of the struct. + /// + /// Unused + /// + /// + /// + public RenderTargetViewDescription( + ID3D11Buffer* buffer, + Format format, + uint firstElement, + uint numElements) + { + Format = format; + ViewDimension = RtvDimension.Buffer; + Anonymous = default; + + Anonymous.Buffer.FirstElement = firstElement; + Anonymous.Buffer.NumElements = numElements; + } + + public RenderTargetViewDescription( + ID3D11Texture1D* texture, + bool isArray, + Format format = Format.Unknown, + uint mipSlice = 0, + uint firstArraySlice = 0, + uint arraySize = unchecked((uint)-1)) + { + ViewDimension = isArray ? RtvDimension.Texture1DArray : RtvDimension.Texture1D; + if (format == Format.Unknown + || (arraySize == unchecked((uint)-1) && RtvDimension.Texture1DArray == ViewDimension)) + { + Texture1DDescription textureDesc; + texture->GetDesc(&textureDesc); + + if (format == Format.Unknown) + format = textureDesc.Format; + if (arraySize == unchecked((uint)-1)) + arraySize = textureDesc.ArraySize - firstArraySlice; + } + + Format = format; + Anonymous = default; + + switch (ViewDimension) + { + case RtvDimension.Texture1D: + Anonymous.Texture1D.MipSlice = mipSlice; + break; + case RtvDimension.Texture1DArray: + Anonymous.Texture1DArray.MipSlice = mipSlice; + Anonymous.Texture1DArray.FirstArraySlice = firstArraySlice; + Anonymous.Texture1DArray.ArraySize = arraySize; + break; + default: + break; + } + } + + /// + /// Initializes a new instance of the struct. + /// + /// + /// + /// + /// + /// + /// + public RenderTargetViewDescription( + ID3D11Texture2D* texture, + RtvDimension viewDimension, + Format format = Format.Unknown, + uint mipSlice = 0, + uint firstArraySlice = 0, + uint arraySize = unchecked((uint)-1)) + { + ViewDimension = viewDimension; + if (format == Format.Unknown + || (arraySize == unchecked((uint)-1) && (RtvDimension.Texture2DArray == viewDimension || RtvDimension.Texture2DMsArray == viewDimension))) + { + Texture2DDescription textureDesc; + texture->GetDesc(&textureDesc); + + if (format == Format.Unknown) + format = textureDesc.Format; + if (arraySize == unchecked((uint)-1)) + { + arraySize = textureDesc.ArraySize - firstArraySlice; + } + } + + Format = format; + Anonymous = default; + switch (viewDimension) + { + case RtvDimension.Texture2D: + Anonymous.Texture2D.MipSlice = mipSlice; + break; + case RtvDimension.Texture2DArray: + Anonymous.Texture2DArray.MipSlice = mipSlice; + Anonymous.Texture2DArray.FirstArraySlice = firstArraySlice; + Anonymous.Texture2DArray.ArraySize = arraySize; + break; + case RtvDimension.Texture2DMs: + break; + case RtvDimension.Texture2DMsArray: + Anonymous.Texture2DMSArray.FirstArraySlice = firstArraySlice; + Anonymous.Texture2DMSArray.ArraySize = arraySize; + break; + default: + break; + } + } + + /// + /// Initializes a new instance of the struct. + /// + /// + /// + /// + /// + /// + public RenderTargetViewDescription( + ID3D11Texture3D* texture, + Format format = Format.Unknown, + uint mipSlice = 0, + uint firstWSlice = 0, + uint wSize = unchecked((uint)-1)) + { + ViewDimension = RtvDimension.Texture3D; + if (format == Format.Unknown || wSize == unchecked((uint)-1)) + { + Texture3DDescription textureDesc; + texture->GetDesc(&textureDesc); + + if (format == Format.Unknown) + format = textureDesc.Format; + if (wSize == unchecked((uint)-1)) + wSize = textureDesc.Depth - firstWSlice; + } + + Format = format; + Anonymous = default; + + Anonymous.Texture3D.MipSlice = mipSlice; + Anonymous.Texture3D.FirstWSlice = firstWSlice; + Anonymous.Texture3D.WSize = wSize; + } +} diff --git a/src/Vortice.Win32/Graphics/Direct3D11/Texture1DDescription.cs b/src/Vortice.Win32/Graphics/Direct3D11/Texture1DDescription.cs new file mode 100644 index 0000000..c57598e --- /dev/null +++ b/src/Vortice.Win32/Graphics/Direct3D11/Texture1DDescription.cs @@ -0,0 +1,50 @@ +// Copyright © Amer Koleci and Contributors. +// Licensed under the MIT License (MIT). See LICENSE in the repository root for more information. + +using Win32.Graphics.Dxgi.Common; +using static Win32.Graphics.Direct3D11.Apis; + +namespace Win32.Graphics.Direct3D11; + +public partial struct Texture1DDescription +{ + /// + /// Initializes a new instance of the struct. + /// + /// Texture format. + /// Texture width (in texels). + /// Number of textures in the array. + /// The maximum number of mipmap levels in the texture. + /// The for binding to pipeline stages. + /// Value that identifies how the texture is to be read from and written to. + /// The to specify the types of CPU access allowed. + /// The that identify other, less common resource options. + public Texture1DDescription( + Format format, + uint width, + uint arraySize = 1, + uint mipLevels = 0, + BindFlags bindFlags = BindFlags.ShaderResource, + Usage usage = Usage.Default, + CpuAccessFlags cpuAccessFlags = CpuAccessFlags.None, + ResourceMiscFlags miscFlags = ResourceMiscFlags.None) + { + if (format == Format.Unknown) + throw new ArgumentException($"format need to be valid", nameof(format)); + + if (width < 1 || width > D3D11_REQ_TEXTURE1D_U_DIMENSION) + throw new ArgumentException($"Width need to be in range 1-{D3D11_REQ_TEXTURE1D_U_DIMENSION}", nameof(width)); + + if (arraySize < 1 || arraySize > D3D11_REQ_TEXTURE1D_ARRAY_AXIS_DIMENSION) + throw new ArgumentException($"Array size need to be in range 1-{D3D11_REQ_TEXTURE1D_ARRAY_AXIS_DIMENSION}", nameof(arraySize)); + + Width = width; + MipLevels = mipLevels; + ArraySize = arraySize; + Format = format; + Usage = usage; + BindFlags = bindFlags; + CPUAccessFlags = cpuAccessFlags; + MiscFlags = miscFlags; + } +} diff --git a/src/Vortice.Win32/Graphics/Direct3D11/Texture2DDescription.cs b/src/Vortice.Win32/Graphics/Direct3D11/Texture2DDescription.cs new file mode 100644 index 0000000..0b59ee1 --- /dev/null +++ b/src/Vortice.Win32/Graphics/Direct3D11/Texture2DDescription.cs @@ -0,0 +1,61 @@ +// Copyright © Amer Koleci and Contributors. +// Licensed under the MIT License (MIT). See LICENSE in the repository root for more information. + +using Win32.Graphics.Dxgi.Common; +using static Win32.Graphics.Direct3D11.Apis; + +namespace Win32.Graphics.Direct3D11; + +public partial struct Texture2DDescription +{ + /// + /// Initializes a new instance of the struct. + /// + /// Texture format. + /// Texture width (in texels). + /// Texture height (in texels). + /// Number of textures in the array. + /// The maximum number of mipmap levels in the texture. + /// The for binding to pipeline stages. + /// Value that identifies how the texture is to be read from and written to. + /// The to specify the types of CPU access allowed. + /// Specifies multisampling parameters for the texture. + /// Specifies multisampling parameters for the texture. + /// The that identify other, less common resource options. + public Texture2DDescription( + Format format, + uint width, + uint height, + uint arraySize = 1, + uint mipLevels = 0, + BindFlags bindFlags = BindFlags.ShaderResource, + Usage usage = Usage.Default, + CpuAccessFlags cpuAccessFlags = CpuAccessFlags.None, + uint sampleCount = 1, + uint sampleQuality = 0, + ResourceMiscFlags miscFlags = ResourceMiscFlags.None) + { + if (format == Format.Unknown) + throw new ArgumentException($"format need to be valid", nameof(format)); + + if (width < 1 || width > D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION) + throw new ArgumentException($"Width need to be in range 1-{D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION}", nameof(width)); + + if (height < 1 || height > D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION) + throw new ArgumentException($"Height need to be in range 1-{D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION}", nameof(height)); + + if (arraySize < 1 || arraySize > D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION) + throw new ArgumentException($"Array size need to be in range 1-{D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION}", nameof(arraySize)); + + Width = width; + Height = height; + MipLevels = mipLevels; + ArraySize = arraySize; + Format = format; + SampleDesc = new(sampleCount, sampleQuality); + Usage = usage; + BindFlags = bindFlags; + CPUAccessFlags = cpuAccessFlags; + MiscFlags = miscFlags; + } +} diff --git a/src/Vortice.Win32/Graphics/Direct3D11/Texture3DDescription.cs b/src/Vortice.Win32/Graphics/Direct3D11/Texture3DDescription.cs new file mode 100644 index 0000000..58c34cc --- /dev/null +++ b/src/Vortice.Win32/Graphics/Direct3D11/Texture3DDescription.cs @@ -0,0 +1,56 @@ +// Copyright © Amer Koleci and Contributors. +// Licensed under the MIT License (MIT). See LICENSE in the repository root for more information. + +using Win32.Graphics.Dxgi.Common; +using static Win32.Graphics.Direct3D11.Apis; + +namespace Win32.Graphics.Direct3D11; + +public partial struct Texture3DDescription +{ + /// + /// Initializes a new instance of the struct. + /// + /// Texture width (in texels). + /// Texture height (in texels). + /// Texture depth (in texels). + /// Texture format. + /// The maximum number of mipmap levels in the texture. + /// The for binding to pipeline stages. + /// Value that identifies how the texture is to be read from and written to. + /// The to specify the types of CPU access allowed. + /// The that identify other, less common resource options. + public Texture3DDescription( + Format format, + uint width, + uint height, + uint depth, + uint mipLevels = 0, + BindFlags bindFlags = BindFlags.ShaderResource, + Usage usage = Usage.Default, + CpuAccessFlags cpuAccessFlags = CpuAccessFlags.None, + ResourceMiscFlags miscFlags = ResourceMiscFlags.None) + { + if (format == Format.Unknown) + throw new ArgumentException($"format need to be valid", nameof(format)); + + if (width < 1 || width > D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION) + throw new ArgumentException($"Width need to be in range 1-{D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION}", nameof(width)); + + if (height < 1 || height > D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION) + throw new ArgumentException($"Height need to be in range 1-{D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION}", nameof(height)); + + if (depth < 1 || depth > D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION) + throw new ArgumentException($"Depth need to be in range 1-{D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION}", nameof(depth)); + + Width = width; + Height = height; + Depth = depth; + MipLevels = mipLevels; + Format = format; + Usage = usage; + BindFlags = bindFlags; + CPUAccessFlags = cpuAccessFlags; + MiscFlags = miscFlags; + } +} diff --git a/src/Vortice.Win32/Graphics/Dxgi.Common.Manual.cs b/src/Vortice.Win32/Graphics/Dxgi.Common.Manual.cs index 55e8efd..b25a5dd 100644 --- a/src/Vortice.Win32/Graphics/Dxgi.Common.Manual.cs +++ b/src/Vortice.Win32/Graphics/Dxgi.Common.Manual.cs @@ -51,7 +51,7 @@ public partial struct SampleDescription public static readonly SampleDescription Default = new(1, 0); /// - /// Create new instance of struct. + /// Initializes a new instance of the struct. /// /// /// diff --git a/src/samples/01-ClearScreen/Program.cs b/src/samples/01-ClearScreen/Program.cs index c01738e..df2dabb 100644 --- a/src/samples/01-ClearScreen/Program.cs +++ b/src/samples/01-ClearScreen/Program.cs @@ -10,6 +10,8 @@ using static Win32.Graphics.Direct3D11.Apis; using static Win32.Graphics.Dxgi.Apis; using MessageId = Win32.Graphics.Direct3D11.MessageId; using InfoQueueFilter = Win32.Graphics.Direct3D11.InfoQueueFilter; +using Win32.Graphics.Dxgi.Common; +using System.Numerics; namespace ClearScreen; @@ -39,6 +41,7 @@ public static unsafe class Program { using ComPtr factory = default; uint factoryFlags = 0; + #if DEBUG { using ComPtr dxgiInfoQueue = default; @@ -119,7 +122,7 @@ public static unsafe class Program using ComPtr tempDevice = default; FeatureLevel featureLevel; - using ComPtr immediateContext = default; + using ComPtr tempImmediateContext = default; D3D11CreateDevice( (IDXGIAdapter*)adapter.Get(), @@ -128,7 +131,7 @@ public static unsafe class Program featureLevels, tempDevice.GetAddressOf(), &featureLevel, - immediateContext.GetAddressOf()).ThrowIfFailed(); + tempImmediateContext.GetAddressOf()).ThrowIfFailed(); #if DEBUG using ComPtr d3dDebug = default; @@ -152,5 +155,29 @@ public static unsafe class Program } } #endif + + using ComPtr d3dDevice = default; + using ComPtr immediateContext = default; + + tempDevice.CopyTo(&d3dDevice).ThrowIfFailed(); + tempImmediateContext.CopyTo(&immediateContext).ThrowIfFailed(); + + ReadOnlySpan triangleVertices = stackalloc VertexPositionColor[] + { + new VertexPositionColor(new Vector3(0f, 0.5f, 0.0f), new Vector4(1.0f, 0.0f, 0.0f, 1.0f)), + new VertexPositionColor(new Vector3(0.5f, -0.5f, 0.0f), new Vector4(0.0f, 1.0f, 0.0f, 1.0f)), + new VertexPositionColor(new Vector3(-0.5f, -0.5f, 0.0f), new Vector4(0.0f, 0.0f, 1.0f, 1.0f)) + }; + + using ComPtr vertexBuffer = ((ID3D11Device*)d3dDevice.Get())->CreateBuffer(triangleVertices, BindFlags.VertexBuffer); + + using ComPtr depthStencilTexture = default; + using ComPtr depthStencilTextureView = default; + + Texture2DDescription texture2DDesc = new(Format.D32Float, 256, 256, 1, 1, BindFlags.DepthStencil); + tempDevice.Get()->CreateTexture2D(&texture2DDesc, null, depthStencilTexture.GetAddressOf()).ThrowIfFailed(); + depthStencilTexture.Get()->GetDesc(&texture2DDesc); + + tempDevice.Get()->CreateDepthStencilView((ID3D11Resource*)depthStencilTexture.Get(), null, depthStencilTextureView.GetAddressOf()).ThrowIfFailed(); } } diff --git a/src/samples/01-ClearScreen/VertexPositionColor.cs b/src/samples/01-ClearScreen/VertexPositionColor.cs new file mode 100644 index 0000000..adaca62 --- /dev/null +++ b/src/samples/01-ClearScreen/VertexPositionColor.cs @@ -0,0 +1,31 @@ +// Copyright © Amer Koleci and Contributors. +// Licensed under the MIT License (MIT). See LICENSE in the repository root for more information. + +using Win32; +using Win32.Graphics.Direct3D; +using Win32.Graphics.Direct3D11; +using Win32.Graphics.Dxgi; +using static Win32.Apis; +using static Win32.Graphics.Direct3D11.Apis; +using static Win32.Graphics.Dxgi.Apis; +using MessageId = Win32.Graphics.Direct3D11.MessageId; +using InfoQueueFilter = Win32.Graphics.Direct3D11.InfoQueueFilter; +using Win32.Graphics.Dxgi.Common; +using System.Drawing; +using System.Numerics; + +namespace ClearScreen; + +public readonly struct VertexPositionColor +{ + public static readonly unsafe int SizeInBytes = sizeof(VertexPositionColor); + + public VertexPositionColor(in Vector3 position, in Vector4 color) + { + Position = position; + Color = color; + } + + public readonly Vector3 Position; + public readonly Vector4 Color; +}