PFND3DDDI_UNLOCK funzione di callback (d3dumddi.h)
La funzione sblocco sblocca una risorsa o una superficie all'interno della risorsa bloccata in precedenza dalla funzione lock.
Sintassi
PFND3DDDI_UNLOCK Pfnd3dddiUnlock;
HRESULT Pfnd3dddiUnlock(
HANDLE hDevice,
const D3DDDIARG_UNLOCK *unnamedParam2
)
{...}
Parametri
hDevice
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
pData [in]
Puntatore a una struttura D3DDDIARG_UNLOCK che descrive la risorsa o la superficie all'interno della risorsa da sbloccare.
Valore restituito
Unlock restituisce uno dei valori seguenti:
| codice restituito | Descrizione |
|---|---|
| S_OK | La risorsa viene sbloccata correttamente. |
| E_OUTOFMEMORY | Lo sblocco non è riuscito ad allocare la memoria necessaria per il completamento. |
| E_INVALIDARG | La risorsa descritta D3DDDIARG_UNLOCK non è stata bloccata da una chiamata precedente alla funzione Lock del driver. |
Osservazioni
Questi commenti sono analoghi alla descrizione nella sezione Osservazioni della pagina di riferimento blocco.
Il driver di visualizzazione in modalità utente deve chiamare la funzione di pfnUnlockCb del runtime Microsoft Direct3D dopo aver chiamato Unlock. In questo pfnUnlockCb chiamata, il driver di visualizzazione in modalità utente passa un handle di allocazione. Prima di chiamare pfnUnlockCb, il driver di visualizzazione in modalità utente deve prima eseguire il mapping della superficie a un'allocazione appropriata.
Il runtime chiama la funzione di Unlock del driver di visualizzazione in modalità utente per sbloccare anche le superfici di memoria di sistema preallocate. Il runtime imposta il flag NotifyOnly campo di bit nel membro flag di della struttura di D3DDDIARG_UNLOCK a cui punta pData distinguere le chiamate Sblocca sbloccare la memoria di sistema preallocata da altre chiamate di sblocco di sblocco. Se il driver di visualizzazione in modalità utente funzione lock chiamata pfnLockCb per bloccare l'allocazione della memoria di sistema corrispondente alla superficie, deve anche chiamare pfnUnlockCb. Non chiamando pfnUnlockCb interrompe il coordinamento tra il runtime, il driver di visualizzazione in modalità utente e il driver miniport di visualizzazione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| piattaforma di destinazione | Universale |
| intestazione | d3dumddi.h (include D3dumddi.h) |