D3DDDI_ALLOCATIONLIST 구조체(d3dukmdt.h)

아티클
03/30/2023

D3DDDI_ALLOCATIONLIST 구조는 DMA(직접 메모리 액세스) 버퍼링에 사용되는 할당 사양에 대한 정보를 설명합니다.

구문

typedef struct _D3DDDI_ALLOCATIONLIST {
  D3DKMT_HANDLE hAllocation;
  union {
    struct {
      UINT WriteOperation : 1;
      UINT DoNotRetireInstance : 1;
      UINT OfferPriority : 3;
#if ...
      UINT Reserved : 27;
#else
      UINT Reserved : 30;
#endif
    };
    UINT Value;
  };
} D3DDDI_ALLOCATIONLIST;

멤버

hAllocation

[in] D3DDDI_OPENALLOCATIONINFO 구조체의 hAllocation 멤버에 있는 D3DKMTOpenResource 함수 또는 D3DDDI_ALLOCATIONINFO구조체의 hAllocation 멤버에 있는 D3DKMTCreateAllocation 함수에 의해 반환된 할당 핸들입니다.

WriteOperation

[in] 할당을 쓸 수 있는지 여부에 대한 정보를 저장할 수 있는 UINT입니다. 를 1로 설정하면 할당을 쓸 수 있음을 나타냅니다.

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

DoNotRetireInstance

[in] 할당을 사용 중지할 수 있는지 여부에 대한 정보를 저장할 수 있는 UINT입니다. 를 1로 설정하면 드라이버가 후속 DMA 버퍼(예: 여러 컨텍스트로 DMA 버퍼의 수동 브로드캐스트)에서 다시 참조하므로 비디오 메모리 관리자가 할당의 instance 사용 중지하지 않아야 합니다. 할당의 모든 인스턴스는 결국 사용 중지됩니다. 이 플래그는 거의 사용되지 않습니다.

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

OfferPriority

[in] 사용자 모드 표시 드라이버가 재사용을 위해 제공하는 비디오 메모리 리소스의 중요성을 나타내는 D3DDDI_OFFER_PRIORITY 열거형의 값입니다.

OfferPriority에 D3DDDI_OFFER_PRIORITY_NONE 값이 없으면 DMA 버퍼가 처리된 후 할당이 제공되는 것으로 간주됩니다.

이 멤버를 설정하는 것은 32비트 Value 멤버(0x0000001C)의 비트 3~5를 설정하는 것과 같습니다.

Windows 8 부터 지원합니다.

Reserved

[in] 이 멤버는 예약되어 있으며 0으로 설정해야 합니다.

Value

[in] DMA 버퍼링에 사용되는 할당 사양에 대한 정보를 식별하는 32비트 값입니다.