Metodo IDirectDrawSurface7::Lock (ddraw.h)

Ottiene un puntatore alla memoria superficiale.

Sintassi

HRESULT Lock(
  [in]      LPRECT           unnamedParam1,
  [in, out] LPDDSURFACEDESC2 unnamedParam2,
  [in]      DWORD            unnamedParam3,
  [in]      HANDLE           unnamedParam4
);

Parametri

[in] unnamedParam1

Puntatore a una struttura RECT che identifica l'area della superficie bloccata. Se questo parametro è NULL, l'intera superficie è bloccata.

[in, out] unnamedParam2

Puntatore a una struttura DDSURFACEDESC2 che descrive i dettagli rilevanti sulla superficie e che riceve informazioni sulla superficie.

[in] unnamedParam3

Combinazione di flag che determinano come bloccare la superficie. Vengono definiti i flag seguenti:

DDLOCK_DONOTWAIT

Nelle interfacce IDirectDrawSurface7 il valore predefinito è DDLOCK_WAIT. Se si vuole eseguire l'override del valore predefinito e usare il tempo in cui l'acceleratore è occupato (come indicato dal valore restituito DDERR_WASSTILLDRAWING), usare DDLOCK_DONOTWAIT.

DDLOCK_EVENT

Non implementato attualmente.

DDLOCK_NOOVERWRITE

Novità per DirectX 7.0. Usato solo con blocchi del vertex buffer Direct3D. Indica che nessun vertice a cui viene fatto riferimento in un'operazione di disegno dall'inizio del frame (o dall'ultimo blocco senza questo flag) viene modificato durante il blocco. Ciò può essere utile quando si desidera aggiungere dati solo al vertex buffer.

DDLOCK_NOSYSLOCK

Non prendere Win16Mutex (noto anche come Win16Lock). Questo flag viene ignorato quando si blocca la superficie primaria.

DDLOCK_DISCARDCONTENTS

Novità per DirectX 7.0. Usato solo con blocchi del vertex buffer Direct3D. Indica che non vengono effettuate ipotesi sul contenuto del buffer dei vertici durante questo blocco. In questo modo Direct3D o il driver possono fornire un'area di memoria alternativa come vertex buffer. Ciò è utile quando si prevede di cancellare il contenuto del vertex buffer e di compilare nuovi dati.

DDLOCK_OKTOSWAP

Questo flag è obsoleto ed è stato sostituito dal flag DDLOCK_DISCARDCONTENTS.

DDLOCK_READONLY

Indica che la superficie bloccata può essere di sola lettura.

DDLOCK_SURFACEMEMORYPTR

Indica che deve essere restituito un puntatore di memoria valido all'inizio del rettangolo specificato. Se non viene specificato alcun rettangolo, viene restituito un puntatore alla parte superiore della superficie. Questo è il valore predefinito.

DDLOCK_WAIT

Se non è possibile ottenere un blocco perché è in corso un'operazione bit block transfer (bitblt), i tentativi di blocco fino a quando non viene ottenuto un blocco o si verifica un altro errore, ad esempio DDERR_SURFACEBUSY.

DDLOCK_WRITEONLY

Indica che la superficie bloccata è abilitata per la scrittura.

[in] unnamedParam4

Handle dell'evento. Questo parametro non è attualmente utilizzato e deve essere impostato su NULL.

Valore restituito

Se il metodo ha esito positivo, il valore restituito viene DD_OK.

Se ha esito negativo, il metodo può restituire uno dei valori di errore seguenti:

• DDERR_INVALIDOBJECT
• DDERR_INVALIDPARAMS
• DDERR_OUTOFMEMORY
• DDERR_SURFACEBUSY
• DDERR_SURFACELOST
• DDERR_WASSTILLDRAWING

Commenti

In IDirectDrawSurface7 il comportamento predefinito di Lock deve attendere il completamento dell'acceleratore. Pertanto, in condizioni predefinite, Lock non restituisce mai DDERR_WASSTILLDRAWING. Se si desidera visualizzare i codici di errore e non attendere che l'operazione bitblt abbia esito positivo, usare il flag DDLOCK_DONOTWAIT.

Dopo aver recuperato un puntatore alla memoria della superficie, è possibile accedere alla memoria della superficie fino a quando non viene chiamato un metodo IDirectDrawSurface7::Unlock corrispondente. Quando la superficie viene sbloccata, il puntatore alla memoria della superficie non è valido.

Non chiamare le funzioni bitblt directDraw in bitblt da un'area bloccata di una superficie. In tal caso, bitblt restituisce DDERR_SURFACEBUSY o DDERR_LOCKEDSURFACES. Anche le funzioni di blit GDI hanno esito negativo in modo invisibile all'utente quando vengono usate su una superficie di memoria video bloccata.

A meno che non includa il flag DDLOCK_NOSYSLOCK, Lock fa sì che DirectDraw contenga Win16Mutex (noto anche come Win16Lock) fino a quando non chiami il metodo IDirectDrawSurface7::Unlock . I debugger GUI non possono funzionare mentre win16Mutex è mantenuto.

Requisiti

Vedi anche

IDirectDrawSurface7