D3DDDIARG_LOCKASYNC 구조체(d3dumddi.h)
D3DDDIARG_LOCKASYNC 구조는 잠글 리소스 또는 리소스 내의 표면을 설명합니다.
구문
typedef struct _D3DDDIARG_LOCKASYNC {
[in] HANDLE hResource;
[in] UINT SubResourceIndex;
[in] D3DDDI_LOCKASYNCFLAGS Flags;
union {
[in] D3DDDIRANGE Range;
[in] RECT Area;
[in] D3DDDIBOX Box;
};
[out] HANDLE hCookie;
[out] VOID *pSurfData;
[out] UINT Pitch;
[out] UINT SlicePitch;
D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DDDIARG_LOCKASYNC;
멤버
[in] hResource
잠글 리소스에 대한 핸들입니다.
[in] SubResourceIndex
hResource가 지정하는 리소스에 대한 인덱스(0부터 시작)입니다. 이 인덱스 는 잠글 하위 리소스 또는 표면을 나타냅니다.
[in] Flags
비트 필드 플래그에서 리소스를 잠그는 방법을 나타내는 D3DDDI_LOCKASYNCFLAGS 구조체입니다.
[in] Range
RangeValid 비트 필드 플래그가 Flags가 지정하는 D3DDDI_LOCKASYNCFLAGS 구조체에서 설정된 경우 잠글 선형 리소스의 하위 범위를 설명하는 D3DDDIRANGE 구조체입니다.
[in] Area
AreaValid 비트 필드 플래그가 Flags가 지정하는 D3DDDI_LOCKASYNCFLAGS 구조체에서 설정된 경우 잠글 표면의 하위 사각형을 설명하는 RECT 구조체입니다.
[in] Box
BoxValid 비트 필드 플래그가 Flags가 지정하는 D3DDDI_LOCKASYNCFLAGS 구조체에서 설정된 경우 잠글 볼륨의 하위 구조를 설명하는 D3DDDIBOX 구조체입니다.
[out] hCookie
이름이 바뀐 리소스를 나타내는 핸들입니다. 이 핸들은 플래그가 지정하는 D3DDDI_LOCKASYNCFLAGS 구조에서 삭제 비트 필드 플래그가 설정된 경우에만 유효합니다.
[out] pSurfData
잠긴 리소스의 메모리 영역에 대한 포인터입니다. 사용자 모드 표시 드라이버의 LockAsync 함수는 이 포인터를 Microsoft Direct3D 런타임에 반환합니다.
[out] Pitch
잠긴 표면의 피치(바이트)입니다. 사용자 모드 표시 드라이버의 LockAsync 함수는 이 피치 값을 Direct3D 런타임에 반환합니다.
[out] SlicePitch
잠긴 표면의 조각 피치(바이트)입니다. 사용자 모드 표시 드라이버의 LockAsync 함수는 이 조각 피치 값을 Direct3D 런타임에 반환합니다.
GpuVirtualAddress
이 멤버는 예약되어 있으며 0으로 설정해야 합니다.
이 멤버는 Windows 7부터 사용할 수 있습니다.
설명
Flags 멤버가 지정하는 D3DDDI_LOCKASYNCFLAGS 구조체의 멤버는 다음 규칙을 준수해야 합니다.
- NoOverwrite 비트 필드 플래그를 삭제 비트 필드 플래그와 동시에 설정하면 안 됩니다.
- RangeValid, AreaValid 및 BoxValid 비트 필드 플래그 중 하나만 언제든지 설정해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 머리글 | d3dumddi.h(D3dumddi.h 포함) |