D3DDDICB_SETPRIORITY-Struktur (d3dumddi.h)

Die D3DDDICB_SETPRIORITY-Struktur beschreibt die Prioritätsebene, auf die eine Ressource oder Liste von Zuordnungen festgelegt werden soll.

Syntax

typedef struct _D3DDDICB_SETPRIORITY {
  [in] HANDLE              hResource;
  [in] UINT                NumAllocations;
  [in] const D3DKMT_HANDLE *HandleList;
  [in] const UINT          *pPriorities;
} D3DDDICB_SETPRIORITY;

Member

[in] hResource

Ein Handle für eine Ressource, deren Priorität festgelegt werden muss. Wenn der Benutzermodusanzeigetreiber das von HandleList angegebene Array verwendet, um die Priorität für die Liste der Zuordnungen festzulegen, legt er hResource auf NULL fest. Wenn der Benutzermodusanzeigetreiber hResource auf einen Wert ohne NULL festlegt, muss der NumAllocations-Member auf null und HandleList auf NULL festgelegt werden.

Wenn hResource nicht NULL ist, werden alle Zuordnungen, die zur Ressource gehören, auf die Priorität festgelegt, die vom ersten Element im Array angegeben wird, auf das pPriorities verweist.

[in] NumAllocations

Die Anzahl der Zuordnungen im HandleList-Array . Wenn der Benutzermodusanzeigetreiber das Handle im hResource-Member auf einen Wert ohne NULL festlegt, muss NumAllocations auf 0 festgelegt werden.

[in] HandleList

Ein Array von D3DKMT_HANDLE Datentypen, die Kernelmodushandles für die Zuordnungen darstellen. Die PfnAllocateCb-Funktion der Microsoft Direct3D-Runtime gibt diese Handles zurück. Daher verwendet der Benutzermodusanzeigetreiber diese Handles, um die Priorität für die Zuordnungen festzulegen.

Wenn der Anzeigetreiber für den Benutzermodus das Handle im hResource-Member auf einen Wert ohne NULL festlegt, muss HandleList auf NULL festgelegt werden.

[in] pPriorities

Ein Zeiger auf ein Array von Prioritätsebenen. Wenn das hResource-Element nicht NULL ist, muss das Array ein einzelnes Element enthalten. Wenn hResourceNULL ist, wird die Anzahl der Elemente im Array vom NumAllocations-Member angegeben, und jede Zuordnung in dem Array, das von HandleList angegeben wird, wird auf die Prioritätsebene des entsprechenden Elements in pPriorities festgelegt. Eine Liste der definierten Prioritätsebenen finden Sie im Abschnitt Hinweise auf der Referenzseite pfnSetPriorityCb .

Anforderungen

Weitere Informationen

pfnAllocateCb

pfnSetPriorityCb