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