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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista (WDDM 1.0) |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | PASSIVE_LEVEL |