DXGKCB_ENUMHANDLECHILDREN Rückruffunktion (d3dkmddi.h)

DXGKCB_ENUMHANDLECHILDREN aufzählt die Zuordnungen, die einer bestimmten Ressource zugeordnet sind, jeweils eine Zuordnung.

Syntax

DXGKCB_ENUMHANDLECHILDREN DxgkcbEnumhandlechildren;

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

Parameter

[in] unnamedParam1

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

Rückgabewert

DXGKCB_ENUMHANDLECHILDREN gibt den Dxgkrnl--spezifischen Handle für die untergeordnete Zuordnung zurück, die pData- beschreibt. Zum Abrufen der gerätespezifischen Daten für den Handle muss der Miniporttreiber die DXGKCB_GETHANDLEDATA-Funktion 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-Grafik-Kernelsubsystem den Handle nicht in die übergeordnete Ressource auflösen, z. B. die folgenden Möglichkeiten:

• Ein ungültiger Handle wurde aufgrund eines böswilligen Angriffs oder eines anderen Fehlers vom Anzeigetreiber des Benutzermodus empfangen.
• Zuordnungen hatten Lebenszyklusprobleme.

Wenn ein NULL- Handle unerwartet zurückgegeben wird, sollte der Anzeigeminiporttreiber die derzeit ausgeführte DDI-Funktion mit STATUS_INVALID_HANDLE nicht ausführen.

Bemerkungen

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

Die Zuordnungshandleindizes sind nullbasiert. Wenn der Miniporttreiber pData->Index auf 0 festlegt, gibt DXGKCB_ENUMHANDLECHILDREN den ersten Zuordnungshandle zurück; wenn Index- auf 1 festgelegt ist, gibt DXGKCB_ENUMHANDLECHILDREN den zweiten Zuordnungshandle zurück; Und so weiter. 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 Dxgkrnlimplementiert. Um diese Rückruffunktion zu verwenden, legen Sie die entsprechenden Member von DXGKARGCB_ENUMHANDLECHILDREN fest, und rufen Sie dann DxgkCbEnumHandleChildren über die DXGKRNL_INTERFACEauf.

Anforderungen

Siehe auch

DXGKARGCB_ENUMHANDLECHILDREN

DXGKCB_GETHANDLEDATA

DXGKRNL_INTERFACE