DXGKCB_GETHANDLEPARENT Rückruffunktion (d3dkmddi.h)

  • Artikel

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. Bei diesem Handle muss es sich um das Kernelmodushandle handeln, das dem DirectX-Grafikkernsubsystem (Dxgkrnl.sys) für die Zuordnung zugewiesen ist.

Rückgabewert

DXGKCB_GETHANDLEPARENT gibt ein grafiksubsystemspezifisches Handle an die übergeordnete Ressource für die Zuordnung zurück, die dem Handle zugeordnet ist, das 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ü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 ein NULL-Handle zurückgegeben wird, sollte der Anzeigeminiporttreiber die derzeit ausgeführte DDI-Funktion mit STATUS_INVALID_HANDLE nicht ausführen.

Hinweise

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 Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, rufen Sie DxgkCbGetHandleParent ü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 < DISPATCH_LEVEL

Weitere Informationen

DXGKRNL_INTERFACE