DXGKCB_GETHANDLEPARENT Rückruffunktion (d3dkmddi.h)
DXGKCB_GETHANDLEPARENT ruft die übergeordnete Ressource aus der angegebenen Zuordnung ab.
Syntax
DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;
D3DKMT_HANDLE DxgkcbGethandleparent(
[in] IN_D3DKMT_HANDLE hAllocation
)
{...}
Parameter
[in] hAllocation
Ein Handle für eine Zuordnung. Dieses Handle muss das Kernelmodushandle sein, das dem DirectX-Grafik-Kernelsubsystem (Dxgkrnl.sys) für die Zuordnung zugewiesen ist.
Rückgabewert
DXGKCB_GETHANDLEPARENT gibt ein grafiksubsystemspezifisches Handle für die übergeordnete Ressource für die Zuordnung zurück, die dem Handle zugeordnet ist, den der hAllocation Parameter angibt.
Wenn DXGKCB_GETHANDLEPARENT ein NULL-Handle zurückgibt, konnte Dxgkrnl.sys das Handle aus einem Grund wie den folgenden Möglichkeiten nicht in die übergeordnete Ressource auflösen:
- 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 zurückgegeben wird, sollte der Anzeige-Miniporttreiber die derzeit ausgeführte DDI-Funktion mit STATUS_INVALID_HANDLE nicht ausführen.
Bemerkungen
Damit DXGKCB_GETHANDLEPARENT ein Ressourcenhandle zurückgeben kann, muss das Handle in hAllocation- ein Zuordnungshandle sein, das einer Ressource zugeordnet ist; andernfalls gibt DXGKCB_GETHANDLEPARENT NULL zurück.
DXGKCB_XXX Funktionen werden von Dxgkrnlimplementiert. Rufen Sie DxgkCbGetHandleParent über die DXGKRNL_INTERFACEauf, um diese Rückruffunktion zu verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista (WDDM 1.0) |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h (einschließlich D3dkmddi.h) |
| IRQL- | < DISPATCH_LEVEL |