D3DKMTSetAllocationPriority-Funktion (d3dkmthk.h)

  • Artikel

Die D3DKMTSetAllocationPriority-Funktion legt die Prioritätsebene einer Ressource oder Liste von Zuordnungen fest.

Syntax

NTSTATUS D3DKMTSetAllocationPriority(
  [in] const D3DKMT_SETALLOCATIONPRIORITY *unnamedParam1
);

Parameter

[in] unnamedParam1

Ein Zeiger auf eine D3DKMT_SETALLOCATIONPRIORITY Struktur, die Informationen zum Festlegen der Prioritätsebene einer Ressource oder Liste von Zuordnungen enthält.

Rückgabewert

D3DKMTSetAllocationPriority gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS Die Prioritätsebene für Zuordnungen wurde erfolgreich festgelegt.
STATUS_DEVICE_REMOVED Der Grafikkarte wurde beendet oder das Anzeigegerät zurückgesetzt.
STATUS_INVALID_PARAMETER Parameter wurden überprüft und als falsch ermittelt.

Diese Funktion kann auch andere NTSTATUS-Werte zurückgeben.

Hinweise

Im folgenden Codebeispiel wird veranschaulicht, wie ein OpenGL ICD D3DKMTSetAllocationPriority verwenden kann, um die Prioritätsebene einer Ressource (und damit alle Zuordnungen, die der Ressource zugeordnet sind) festzulegen.

VOID SetResourcePriority(D3DKMT_HANDLE hDevice, D3DKMT_HANDLE hResource, UINT uiPriority)
{
    D3DKMT_SETALLOCATIONPRIORITY SetAllocationPriorityData;

    SetAllocationPriorityData.hDevice = hDevice;
    SetAllocationPriorityData.hResource = hResource;
    SetAllocationPriorityData.phAllocationList = NULL;
    SetAllocationPriorityData.AllocationCount = 0;
    SetAllocationPriorityData.Priorities = &uiPriority;

    (*pfnKTSetAllocationPriority)(&SetAllocationPriorityData);
}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Zielplattform Universell
Header d3dkmthk.h (einschließlich D3dkmthk.h)
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen

D3DKMT_SETALLOCATIONPRIORITY