PFND3DDDI_QUERYRESIDENCYCB funzione di callback (d3dumddi.h)

La funzione pfnQueryResidencyCb esegue una query sullo stato di residenza di una risorsa o di un elenco di allocazioni.

Sintassi

PFND3DDDI_QUERYRESIDENCYCB Pfnd3dddiQueryresidencycb;

HRESULT Pfnd3dddiQueryresidencycb(
  HANDLE hDevice,
  const D3DDDICB_QUERYRESIDENCY *unnamedParam2
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

pData [in, out]

Puntatore a una struttura D3DDDICB_QUERYRESIDENCY che descrive lo stato di residenza di una risorsa o un elenco di allocazioni.

Valore restituito

pfnQueryResidencyCb restituisce uno dei valori seguenti:

Questa funzione potrebbe anche restituire altri valori HRESULT.

Commenti

Il driver di visualizzazione in modalità utente può chiamare la funzione pfnQueryResidencyCb per eseguire una query sullo stato di residenza delle allocazioni tramite una risorsa o tramite un elenco di allocazioni. Se il driver esegue una query sullo stato di residenza delle allocazioni tramite una risorsa, vengono eseguite query su tutte le allocazioni appartenenti alla risorsa. In genere, il driver di visualizzazione in modalità utente esegue una query sulla residenza di una risorsa o un elenco di allocazioni dopo che il runtime di Microsoft Direct3D chiama la funzione QueryResourceResidency o QueryResourceResidencyDXGI del driver di visualizzazione in modalità utente per determinare la residenza di una risorsa. Tuttavia, il driver di visualizzazione in modalità utente può eseguire query sulla residenza di una risorsa o un elenco di allocazioni in qualsiasi momento.

Esempio

Nell'esempio di codice seguente viene illustrato come eseguire una query sullo stato di residenza.

HRESULT
CD3DContext::QueryResourceResidency(CONST D3DDDIARG_QUERYRESOURCERESIDENCY* pQRR)
{
    D3DDDICB_QUERYRESIDENCY queryRes;
    D3DDDI_RESIDENCYSTATUS  resStatus = (D3DDDI_RESIDENCYSTATUS)0;
    HRESULT hr;
    BOOL    bPartInSharedMem = FALSE;

    for (UINT i = 0; i < pQRR->NumResources; i++) {
        memset(&queryRes, 0, sizeof(queryRes));
        queryRes.hResource = m_RTbl[(DWORD)(DWORD_PTR)pQRR->pHandleList[i]].m_hResRuntime;
        if (! queryRes.hResource) {
            return (DDERR_INVALIDPARAMS);
        }
        queryRes.pResidencyStatus = &resStatus;
        hr = m_d3dCallbacks.pfnQueryResidencyCb(m_hD3D, &queryRes);
        if (FAILED(hr)) {
            return (hr);
        }
        switch (resStatus) {
        case D3DDDI_RESIDENCYSTATUS_NOTRESIDENT:
            return S_NOT_RESIDENT;
        case D3DDDI_RESIDENCYSTATUS_RESIDENTINSHAREDMEMORY:
            bPartInSharedMem = TRUE;
            break;
        case D3DDDI_RESIDENCYSTATUS_RESIDENTINGPUMEMORY:
            break;
        default:
            return DDERR_GENERIC;
        }
    }
    if (bPartInSharedMem) {
        return S_RESIDENT_IN_SHARED_MEMORY;
    }
    else {
        return  S_OK;
    }
}

Requisiti

Vedi anche

D3DDDICB_QUERYRESIDENCY

D3DDDI_DEVICECALLBACKS

QueryResourceResidency

QueryResourceResidencyDXGI