DXGKCB_ACQUIREHANDLEDATA Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

DXGKCB_ACQUIREHANDLEDATA ruft einen Verweis auf eine Zuordnung ab.

Syntax

DXGKCB_ACQUIREHANDLEDATA DxgkcbAcquirehandledata;

VOID * DxgkcbAcquirehandledata(
  [in]  IN_CONST_PDXGKARGCB_GETHANDLEDATA unnamedParam1,
  [out] PDXGKARG_RELEASE_HANDLE unnamedParam2
)
{...}

Parameter

[in] unnamedParam1

Zeiger auf eine DXGKARGCB_GETHANDLEDATA-Struktur , die ein von DXGKCB_CREATECONTEXTALLOCATION zurückgegebenes Zuordnungshandle beschreibt.

[out] unnamedParam2

Zeiger auf ein Releasehandle für den Treiber, der beim Freigeben der Zuordnungsreferenz verwendet werden soll.

Rückgabewert

Keine.

Hinweise

Zuordnungshandles können jederzeit durch eine Anwendung oder durch einen Benutzermodustreiberaufruf von D3DKMTDestroyAllocation für ein gültiges Handle zerstört werden. Die Zerstörung der Zuordnung beinhaltet eine Anforderung an den Kernelmodustreiber zum Löschen des Zuordnungsobjekts, das Dxgkrnl während der Zuordnungserstellung zurückgegeben hat, sodass der KMD am Ende einen veralteten Zeiger auf den freigegebenen Speicher erhalten kann. DXGKCB_ACQUIREHANDLEDATA und DXGKCB_RELEASEHANDLEDATA dem Treiber erlauben, einen Verweis auf das Dxgkrnl-Objekt zu speichern und sicherzustellen, dass Dxgkrnl die Zuordnung und die kmD-zugeordneten Objekte erst nach dem Releaseaufruf zerstört.

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