PFND3DDDI_CREATEOVERLAYCB Rückruffunktion (d3dumddi.h)

Die pfnCreateOverlayCb-Funktion erstellt ein Überlagerungsobjekt im Kernelmodus und ruft den Display-Miniporttreiber auf, um das Overlay anzuzeigen.

Syntax

PFND3DDDI_CREATEOVERLAYCB Pfnd3dddiCreateoverlaycb;

HRESULT Pfnd3dddiCreateoverlaycb(
  HANDLE hDevice,
  D3DDDICB_CREATEOVERLAY *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

pData [in, out]

Ein Zeiger auf eine D3DDDICB_CREATEOVERLAY-Struktur , die die zu erstellende Überlagerung beschreibt.

Rückgabewert

pfnCreateOverlayCb gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
S_OK	Das Überlagerungsobjekt wurde erfolgreich erstellt.
D3DDDIERR_NOTAVAILABLE	pfnCreateOverlayCb ist aufgrund fehlender Overlayhardware oder Bandbreite fehlgeschlagen.
E_INVALIDARG	Die Parameter wurden überprüft und als falsch ermittelt.
E_OUTOFMEMORY	PfnCreateOverlayCb konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war.

Diese Funktion gibt möglicherweise auch andere HRESULT-Werte zurück.

Hinweise

Die pfnCreateOverlayCb-Funktion gibt ein Handle an das neu erstellte Kernelmodus-Overlayobjekt im hKernelOverlay-Member der D3DDDICB_CREATEOVERLAY-Struktur zurück, auf die von pData verwiesen wird. Der Anzeigetreiber für den Benutzermodus übergibt dieses Handle in Aufrufen der folgenden Funktionen:

• pfnDestroyOverlayCb

• pfnFlipOverlayCb

• pfnUpdateOverlayCb

Im folgenden Codebeispiel wird gezeigt, wie ein Überlagerungsobjekt erstellt wird.

D3DKMT_HANDLE g_hOverlay = NULL;

HRESULT CD3DContext::CreateOverlay(D3DDDIARG_CREATEOVERLAY* pCreateOverlay) {
    D3DDDICB_CREATEOVERLAY CreateCB;
    DWORD_PTR dwResource = (DWORD_PTR) pCreateOverlay->OverlayInfo.hResource;
    dwResource += pCreateOverlay->OverlayInfo.SubResourceIndex;
    LONG dwTempPitch;

    pCreateOverlay->hOverlay = (HANDLE) 0x27;

    CreateCB.VidPnSourceId = 0;
    CreateCB.OverlayInfo.hAllocation = R200GetAllocationHandle(m_pR200Ctx,
                                     (DWORD)dwResource,
                                      &dwTempPitch);

    CreateCB.OverlayInfo.DstRect.left = pCreateOverlay->OverlayInfo.DstRect.left;
    CreateCB.OverlayInfo.DstRect.right = pCreateOverlay->OverlayInfo.DstRect.right;
    CreateCB.OverlayInfo.DstRect.top = pCreateOverlay->OverlayInfo.DstRect.top;
    CreateCB.OverlayInfo.DstRect.bottom = pCreateOverlay->OverlayInfo.DstRect.bottom;

    CreateCB.OverlayInfo.SrcRect.left = pCreateOverlay->OverlayInfo.SrcRect.left;
    CreateCB.OverlayInfo.SrcRect.right = pCreateOverlay->OverlayInfo.SrcRect.right;
    CreateCB.OverlayInfo.SrcRect.top = pCreateOverlay->OverlayInfo.SrcRect.top;
    CreateCB.OverlayInfo.SrcRect.bottom = pCreateOverlay->OverlayInfo.SrcRect.bottom;

    CreateCB.OverlayInfo.pPrivateDriverData = "This is a test";
    CreateCB.OverlayInfo.PrivateDriverDataSize = 10;

    HRESULT hr = m_d3dCallbacks.pfnCreateOverlayCb(m_hD3D, &CreateCB);

    if (SUCCEEDED(hr)) {
        g_hOverlay = CreateCB.hKernelOverlay;
    }

    return hr;
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDICB_CREATEOVERLAY

D3DDDI_DEVICECALLBACKS

pfnDestroyOverlayCb

pfnFlipOverlayCb

pfnUpdateOverlayCb