DXGKCB_ENUMHANDLECHILDREN Rückruffunktion (d3dkmddi.h)

  • Artikel

DXGKCB_ENUMHANDLECHILDREN listet die Zuordnungen, die einer bestimmten Ressource zugeordnet sind, nacheinander auf.

Syntax

DXGKCB_ENUMHANDLECHILDREN DxgkcbEnumhandlechildren;

D3DKMT_HANDLE DxgkcbEnumhandlechildren(
  [in] IN_CONST_PDXGKARGCB_ENUMHANDLECHILDREN unnamedParam1
)
{...}

Parameter

[in] unnamedParam1

Zeiger auf eine DXGKARGCB_ENUMHANDLECHILDREN Struktur, die die übergeordnete Ressource und den Index der abzurufenden untergeordneten Zuordnung beschreibt.

Rückgabewert

DXGKCB_ENUMHANDLECHILDREN gibt das Dxgkrnl-spezifische Handle an die untergeordnete Zuordnung zurück, die pData beschreibt. Um die gerätespezifischen Daten für das Handle abzurufen, muss der Anzeige-Miniporttreiber die funktion DXGKCB_GETHANDLEDATA aufrufen.

DXGKCB_ENUMHANDLECHILDREN gibt ein NULL-Handle zurück, wenn der im Index-Element der DXGKARGCB_ENUMHANDLECHILDREN-Struktur angegebene Indexwert der untergeordneten Zuordnung die Anzahl der Zuordnungen überschreitet, die der übergeordneten Ressource zugeordnet sind. Wenn DXGKCB_ENUMHANDLECHILDREN unerwartet ein NULL-Handle zurückgibt, konnte das DirectX-Grafikkernsubsystem das Handle aus einem Grund wie den folgenden Möglichkeiten nicht in die übergeordnete Ressource auflösen:

  • Ein ungültiges Handle wurde vom Anzeigetreiber für den Benutzermodus aufgrund eines böswilligen Angriffs oder eines anderen Fehlers empfangen.
  • Bei Zuordnungen gab es Probleme mit der Lebensdauer.

Wenn unerwartet ein NULL-Handle zurückgegeben wird, sollte der Anzeige-Miniporttreiber seine derzeit ausgeführte DDI-Funktion mit STATUS_INVALID_HANDLE fehlschlagen.

Hinweise

Ein Anzeigeminiporttreiber kann DXGKCB_ENUMHANDLECHILDREN in einer Schleife aufrufen, um alle Zuordnungen aufzulisten, die einer Ressource zugeordnet sind.

Die Zuordnungshandleindizes sind nullbasiert. Wenn der Anzeige-Miniporttreiber pData-Index> auf 0 festlegt, gibt DXGKCB_ENUMHANDLECHILDREN das erste Zuordnungshandle zurück. Wenn Index auf 1 festgelegt ist, gibt DXGKCB_ENUMHANDLECHILDREN das zweite Zuordnungshandle zurück usw. Wenn Index größer ist als die Anzahl der Zuordnungen, die der Ressource zugeordnet sind, gibt DXGKCB_ENUMHANDLECHILDRENNULL zurück.

DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, legen Sie die entsprechenden Member von DXGKARGCB_ENUMHANDLECHILDREN fest, und rufen Sie dann DxgkCbEnumHandleChildren über die DXGKRNL_INTERFACE auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista (WDDM 1.0)
Zielplattform Desktop
Kopfzeile d3dkmddi.h (einschließlich D3dkmddi.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

DXGKARGCB_ENUMHANDLECHILDREN

DXGKCB_GETHANDLEDATA

DXGKRNL_INTERFACE