D3DDDIARG_OPENRESOURCE structure (d3dumddi.h)
The D3DDDIARG_OPENRESOURCE structure contains information for opening a shared resource.
Syntax
typedef struct _D3DDDIARG_OPENRESOURCE {
[in] UINT NumAllocations;
union {
[in] D3DDDI_OPENALLOCATIONINFO *pOpenAllocationInfo;
D3DDDI_OPENALLOCATIONINFO2 *pOpenAllocationInfo2;
};
[in] D3DDDI_OPENALLOCATIONINFO *pOpenAllocationInfo;
[in] D3DKMT_HANDLE hKMResource;
[in] VOID *pPrivateDriverData;
[in] UINT PrivateDriverDataSize;
[in/out] HANDLE hResource;
[in] D3DDDI_ROTATION Rotation;
[in] D3DDDI_OPENRESOURCEFLAGS Flags;
} D3DDDIARG_OPENRESOURCE;
Members
[in] NumAllocations
The number of elements in the array that is specified by pOpenAllocationInfo. NumAllocations represents the number of allocations to open.
[in] pOpenAllocationInfo
An array of D3DDDI_OPENALLOCATIONINFO structures that describe the allocations in the resource to open.
[in] An array of D3DDDI_OPENALLOCATIONINFO structures that describe the allocations in the resource to open.
pOpenAllocationInfo2
This member is reserved and should be set to zero.
This member is available beginning with Windows 7.
[in] hKMResource
A D3DKMT_HANDLE data type that represents a kernel-mode handle to the resource that is associated with the allocations.
This kernel-mode handle represents an existing shared resource that was previously created through a call to the user-mode display driver's CreateResource function.
[in] pPrivateDriverData
A pointer to private data that was passed to the display miniport driver when the resource was created. This data is per resource and not per allocation like the private data in each allocation's D3DDDI_OPENALLOCATIONINFO structure.
[in] PrivateDriverDataSize
The size, in bytes, of the private data that is pointed to by pPrivateDriverData.
[in/out] hResource
A handle to the resource that is associated with the allocations.
The user-mode display driver should save this handle and use it to identify the resource anytime that the driver calls back into the Microsoft Direct3D runtime. The user-mode display driver should generate a unique handle and pass it back to the Direct3D runtime. The Direct3D runtime uses this handle in driver calls to identify the resource.
[in] Rotation
A D3DDDI_ROTATION-typed value that identifies the orientation of the shared primary resource.
When the primary resource is used with a full-screen device and is rotated, the driver might be required to create interim allocations to handle the full-screen device. The Fullscreen bitfield flag is set in the Flags member to indicate that the primary resource is used with a full-screen device.
[in] Flags
A D3DDDI_OPENRESOURCEFLAGS structure that identifies the type of resource to open.
Remarks
The Primary and SharedResource bit-field flags are set in the Flags member of the D3DDDIARG_CREATERESOURCE structure in a call to the CreateResource function to create a shared primary resource.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows Vista and later versions of the Windows operating systems. |
| Header | d3dumddi.h (include D3dumddi.h) |