{"id":470,"date":"2011-05-27T17:02:30","date_gmt":"2011-05-28T00:02:30","guid":{"rendered":"http:\/\/mattfife.net\/wordpress\/?p=470"},"modified":"2022-02-11T23:34:21","modified_gmt":"2022-02-12T06:34:21","slug":"gotchas-of-using-id3d11shaderreflection","status":"publish","type":"post","link":"https:\/\/mattfife.com\/?p=470","title":{"rendered":"Gotcha\u2019s of using ID3D11ShaderReflection"},"content":{"rendered":"\n

So, I am working on something that requires I programmatically know what’s in a DX11 shader file.  One of the cool things you can use to figure out how many constant buffers, get string names from position streams, etc – is the DirectX Shader Reflection system<\/a>.  It gives you the ability to query a loaded shader blob for names\/types\/etc.  However, it’s not quite as straightforward as one might expect to use.  The docs were pretty incomplete up until the DX11 version.  But here’s the basics of the ID3D11ShaderReflection <\/a>system:<\/p>\n\n\n\n

  1. Load your vertex\/pixel shaders.\u00a0 Get the actual shader blob – or extract it from the FX system if you used that.<\/li>
  2. Bind it to a shader reflection object using D3DReflect:
    pd3dDevice->CreatePixelShader( pPixelShaderBuffer->GetBufferPointer(), pPixelShaderBuffer->GetBufferSize(), g_pPSClassLinkage, &g_pPixelShader );
    ID3D11ShaderReflection* pReflector = NULL;
    D3DReflect( pPixelShaderBuffer->GetBufferPointer(), pPixelShaderBuffer->GetBufferSize(), IID_ID3D11ShaderReflection, (void**) &pReflector);<\/code><\/pre> <\/li>
  3. Query the reflection object for whatever constant buffer, input\/output stream, or other info you want using the many methods available<\/a>.\u00a0 It’s a GREAT way to test your shaders at load time so you don’t get cryptic runtime errors later when you try to actually draw objects.<\/li><\/ol>\n\n\n\n
    Now, the gotcha’s:<\/p>\n\n\n\n
    1. You must also include this: 
      #include <D3DCompiler.h><\/pre>Or you’ll get a compile error with D3DReflect() – despite the fact the official Microsoft docs seem to say you should (only) include: 
      #include <D3DShader.h><\/pre> <\/li>
    2. Finally, you MUST<\/em> have the DirectX SDK include directory listed before<\/strong><\/em> the windows include directory in the Visual Studio compiler include directory list or you’ll get compile errors in D3DShader.h. This is apparently because the windows headers that come with Visual Studio actually have a few DX definitions in them that conflict with the DX SDK header definitions.\u00a0\u00a0 
      In Visual Studio, check: Tools\/Options -> Project and Solutions -> VC++ Directories<\/strong> and make sure Windows SDK include & library\u00a0paths appear AFTER DirectX include & library paths.\u00a0 See       here for the thread<\/a>.<\/li><\/ol>\n","protected":false},"excerpt":{"rendered":"
      So, I am working on something that requires I programmatically know what’s in a DX11 shader file.  One of the cool things you can use to figure out how many constant buffers, get string names from position streams, etc – is the DirectX Shader Reflection system.  It gives you the ability to query a loaded shader blob for names\/types\/etc.  However, it’s not quite as straightforward as one might expect to use.  The docs were pretty incomplete up until the DX11…<\/p>\n
       Read More  Read More<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":true,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[7],"tags":[],"class_list":["post-470","post","type-post","status-publish","format-standard","hentry","category-technicalprogramming"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p4WECr-7A","jetpack-related-posts":[],"_links":{"self":[{"href":"https:\/\/mattfife.com\/index.php?rest_route=\/wp\/v2\/posts\/470","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mattfife.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mattfife.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/mattfife.com\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/mattfife.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=470"}],"version-history":[{"count":10,"href":"https:\/\/mattfife.com\/index.php?rest_route=\/wp\/v2\/posts\/470\/revisions"}],"predecessor-version":[{"id":6312,"href":"https:\/\/mattfife.com\/index.php?rest_route=\/wp\/v2\/posts\/470\/revisions\/6312"}],"wp:attachment":[{"href":"https:\/\/mattfife.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=470"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mattfife.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=470"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mattfife.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=470"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}