D3DKMT_LOCK structure (d3dkmthk.h)

The D3DKMT_LOCK structure describes parameters for locking an allocation.

Syntax

typedef struct _D3DKMT_LOCK {
  [in]  D3DKMT_HANDLE          hDevice;
  [in]  D3DKMT_HANDLE          hAllocation;
  [in]  UINT                   PrivateDriverData;
  [in]  UINT                   NumPages;
  [in]  const UINT             *pPages;
  [out] VOID                   *pData;
  [in]  D3DDDICB_LOCKFLAGS     Flags;
        D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DKMT_LOCK;

Members

[in] hDevice

A D3DKMT_HANDLE data type that represents a kernel-mode handle to the device that the allocation is associated with.

[in] hAllocation

A D3DKMT_HANDLE data type that represents a kernel-mode handle to the allocation to lock.

[in] PrivateDriverData

A UINT value that specifies 32 bits of private data (for example, MIP level) that is sent from the OpenGL ICD to the display miniport driver's DxgkDdiAcquireSwizzlingRange function.

[in] NumPages

The number of pages in the page list that pPages specifies.

[in] pPages

An array of pages to lock. Each page in the array is described by an integer offset. Zero means the first page in the surface, one means the second, and so on.

[out] pData

A pointer to the memory that is returned from the display miniport driver and memory manager. When locking a memory page list, the pointer that is returned is a pointer to the first memory page.

[in] Flags

A D3DDDICB_LOCKFLAGS structure that identifies, in bit-field flags, how to lock the allocation.

Note that specifying some flags together is invalid and that some flags depend on other flags. For more information about these combinations, see the Remarks section of D3DDDICB_LOCKFLAGS.

GpuVirtualAddress

This member is reserved and should be set to zero.

This member is available beginning with Windows 7.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Header	d3dkmthk.h (include D3dkmthk.h)

See also

D3DDDICB_LOCKFLAGS

D3DKMTLock

DxgkDdiAcquireSwizzlingRange