다음을 통해 공유


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

리소스에 대한 인덱스(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 멤버로 지정된 구조체의 멤버는 다음 규칙을 준수해야 합니다.

  • ReadOnlyWriteOnly 비트 필드 플래그는 동시에 설정해서는 안 됩니다.
  • NoOverwrite 비트 필드 플래그는 무시 비트 필드 플래그와 동시에 설정해서는 안 됩니다.
  • RangeValid, AreaValidBoxValid 비트 필드 플래그 중 하나만 언제든지 설정해야 합니다.
  • ReadOnly 비트 필드 플래그는 무시 비트 필드 플래그와 동시에 설정하면 안 됩니다.

요구 사항

요구
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
헤더 d3dumddi.h(D3dumddi.h 포함)

참고 항목

D3DDDI_LOCKFLAGS

잠금