xrGetD3D12GraphicsRequirementsKHR - Retrieve the D3D12 feature level and graphics device requirements for an instance and system

Parameter Descriptions

Description

The getD3D12GraphicsRequirementsKHR function identifies to the application what graphics device (Windows LUID) needs to be used and the minimum feature level to use. The runtime must return ERROR_GRAPHICS_REQUIREMENTS_CALL_MISSING (ERROR_VALIDATION_FAILURE may be returned due to legacy behavior) on calls to createSession if getD3D12GraphicsRequirementsKHR has not been called for the same instance and systemId. The LUID and feature level that getD3D12GraphicsRequirementsKHR returns should be used to create the ID3D12Device that the application passes to createSession in the GraphicsBindingD3D12KHR.

Valid Usage (Implicit)

• The @@ extension must be enabled prior to calling getD3D12GraphicsRequirementsKHR

• instance must be a valid Instance handle
• graphicsRequirements must be a pointer to an GraphicsRequirementsD3D12KHR structure

Return Codes

Success

• SUCCESS

Failure

• ERROR_HANDLE_INVALID
• ERROR_INSTANCE_LOST
• ERROR_RUNTIME_FAILURE
• ERROR_SYSTEM_INVALID
• ERROR_VALIDATION_FAILURE
• ERROR_FUNCTION_UNSUPPORTED

See Also

GraphicsRequirementsD3D12KHR, Instance, https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrSystemId, createSession

XrGraphicsBindingD3D12KHR - The graphics binding structure to be passed at session creation to use D3D12

Member Descriptions

Description

When creating a D3D12-backed Session, the application will provide a pointer to an GraphicsBindingD3D12KHR in the next chain of the SessionCreateInfo.

Valid Usage (Implicit)

• The @@ extension must be enabled prior to using GraphicsBindingD3D12KHR

• type must be TYPE_GRAPHICS_BINDING_D3D12_KHR
• next must be NULL or a valid pointer to the next structure in a structure chain
• device must be a pointer to an ID3D12Device value
• queue must be a pointer to an ID3D12CommandQueue value

See Also

StructureType, createSession

XrSwapchainImageD3D12KHR - D3D12-specific swapchain image structure

Member Descriptions

Description

If a given session was created with GraphicsBindingD3D12KHR, the following conditions must apply.

• Calls to enumerateSwapchainImages on an Swapchain in that session must return an array of SwapchainImageD3D12KHR structures.
• Whenever an OpenXR function accepts an SwapchainImageBaseHeader pointer as a parameter in that session, the runtime must also accept a pointer to an SwapchainImageD3D12KHR.

The OpenXR runtime must interpret the top-left corner of the swapchain image as the coordinate origin unless specified otherwise by extension functionality.

The OpenXR runtime must interpret the swapchain images in a clip space of positive Y pointing up, near Z plane at 0, and far Z plane at 1.

Valid Usage (Implicit)

• The @@ extension must be enabled prior to using SwapchainImageD3D12KHR

• type must be TYPE_SWAPCHAIN_IMAGE_D3D12_KHR
• next must be NULL or a valid pointer to the next structure in a structure chain
• texture must be a pointer to an ID3D12Resource value

See Also

StructureType, SwapchainImageBaseHeader

XrGraphicsRequirementsD3D12KHR - D3D12 feature level and LUID requirements

Member Descriptions

Description

GraphicsRequirementsD3D12KHR is populated by getD3D12GraphicsRequirementsKHR.

Valid Usage (Implicit)

• The @@ extension must be enabled prior to using GraphicsRequirementsD3D12KHR

• type must be TYPE_GRAPHICS_REQUIREMENTS_D3D12_KHR
• next must be NULL or a valid pointer to the next structure in a structure chain
• adapterLuid must be a valid LUID value
• minFeatureLevel must be a valid D3D_FEATURE_LEVEL value

See Also

StructureType, getD3D12GraphicsRequirementsKHR