D3DDDI_LOCKFLAGS 구조체(d3dumddi.h)

D3DDDI_LOCKFLAGS 구조체는 리소스를 잠그는 방법을 식별합니다.

구문

typedef struct _D3DDDI_LOCKFLAGS {
  union {
    struct {
      UINT ReadOnly : 1;
      UINT WriteOnly : 1;
      UINT NoOverwrite : 1;
      UINT Discard : 1;
      UINT RangeValid : 1;
      UINT AreaValid : 1;
      UINT BoxValid : 1;
      UINT NotifyOnly : 1;
      UINT MightDrawFromLocked : 1;
      UINT DoNotWait : 1;
      UINT Reserved : 22;
    };
    UINT Value;
  };
} D3DDDI_LOCKFLAGS;

멤버

ReadOnly

잠긴 리소스만 읽을 수 있는지 여부를 지정하는 UINT 값입니다. 이 멤버를 설정하는 것은 32비트 Value 멤버(0x00000001)의 첫 번째 비트를 설정하는 것과 같습니다.

WriteOnly

잠긴 리소스만 쓸 수 있는지 여부를 지정하는 UINT 값입니다. 이 멤버를 설정하는 것은 32비트 Value 멤버(0x00000002)의 두 번째 비트를 설정하는 것과 같습니다.

NoOverwrite

잠긴 리소스에 데이터를 추가할 수 있지만 리소스의 기존 데이터를 수정할 수 없는지 여부를 지정하는 UINT 값입니다. 이 멤버는 Direct3D 꼭짓점 버퍼 잠금에만 사용됩니다.

이 멤버를 설정하는 것은 32비트 Value 멤버(0x00000004)의 세 번째 비트를 설정하는 것과 같습니다.

Discard

잠긴 리소스 전체를 수정할지 여부를 지정하는 UINT 값입니다. 따라서 기존 콘텐츠를 삭제할 수 있으므로 예비 처리가 필요하지 않습니다.

이 멤버를 설정하는 것은 32비트 Value 멤버(0x00000008)의 네 번째 비트를 설정하는 것과 같습니다.

RangeValid

잠긴 리소스가 선형인지 여부를 지정하는 UINT 값입니다.

이 멤버를 설정하는 것은 32비트 Value 멤버(0x00000010)의 다섯 번째 비트를 설정하는 것과 같습니다.

AreaValid

잠긴 리소스가 표면인지 여부를 지정하는 UINT 값입니다.

이 멤버를 설정하는 것은 32비트 Value 멤버(0x00000020)의 여섯 번째 비트를 설정하는 것과 같습니다.

BoxValid

잠긴 리소스가 볼륨인지 여부를 지정하는 UINT 값입니다.

이 멤버를 설정하는 것은 32비트 Value 멤버(0x00000040)의 일곱 번째 비트를 설정하는 것과 같습니다.

NotifyOnly

잠금 호출이 알림 전용인지 여부를 지정하는 UINT 값입니다.

이 멤버를 설정하는 것은 32비트 Value 멤버(0x00000080)의 여덟 번째 비트를 설정하는 것과 같습니다.

MightDrawFromLocked

Direct3D 런타임에 의해 꼭짓점 버퍼가 잠겨 있는 경우에도 드라이버가 꼭짓점 버퍼에서 그리도록 요청될 수 있는지 여부를 지정하는 UINT 값입니다. MightDrawFromLocked는 드라이버가 Lock 호출 후 DrawIndexedPrimitive, DrawIndexedPrimitive2, DrawPrimitive 및 DrawPrimitive2 함수 에 대한 호출을 수신하도록 보장하지 않습니다. MightDrawFromLocked는 만들기 시간 동안 D3DDDIARG_CREATERESOURCE 구조체의 Flags 멤버에 설정된 MightDrawFromLocked 비트 필드 플래그를 사용하여 만든 꼭짓점 버퍼에서만 설정됩니다.

이 멤버를 설정하는 것은 32비트 Value 멤버(0x00000100)의 9번째 비트를 설정하는 것과 같습니다.

DoNotWait

사용자 모드 표시 드라이버가 리소스가 유휴 상태가 될 때까지 기다려야 하는지 여부를 지정하는 UINT 값입니다. DoNotWait을 설정하면 사용자 모드 표시 드라이버가 리소스가 유휴 상태가 될 때까지 기다리지 않아야 합니다.

이 멤버를 설정하는 것은 32비트 Value 멤버(0x00000200)의 10번째 비트를 설정하는 것과 같습니다.

Reserved

이 멤버는 예약되어 있으며 0으로 설정해야 합니다. 이 멤버를 0으로 설정하는 것은 32비트 Value 멤버의 나머지 22비트(0xFFFFFC00)를 0으로 설정하는 것과 같습니다.

Value

리소스를 잠그는 방법을 식별하는 하나의 32비트 값을 보유할 수 있는 D3DDDI_LOCKFLAGS 포함된 공용 구조체의 멤버입니다.

요구 사항

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

추가 정보

D3DDDIARG_LOCK