D3DKMTSetAllocationPriority-Funktion (d3dkmthk.h)
Die D3DKMTSetAllocationPriority- Funktion legt die Prioritätsebene einer Ressource oder Liste der 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 | Prioritätsstufe für Zuordnungen wurde erfolgreich festgelegt. |
| STATUS_DEVICE_REMOVED | Der Grafikkarte wurde beendet, oder das Anzeigegerät wurde zurückgesetzt. |
| STATUS_INVALID_PARAMETER | Parameter wurden überprüft und ermittelt, dass sie falsch sind. |
Diese Funktion kann auch andere NTSTATUS- Werte zurückgeben.
Bemerkungen
Im folgenden Codebeispiel wird veranschaulicht, wie ein OpenGL ICD D3DKMTSetAllocationPriority- verwenden kann, um die Prioritätsebene einer Ressource festzulegen (und somit alle Zuordnungen, die der Ressource zugeordnet sind).
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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Universal |
| Header- | d3dkmthk.h (einschließlich D3dkmthk.h) |
| Library | Gdi32.lib |
| DLL- | Gdi32.dll |