Metodo ID2D1DeviceContext::GetTarget (d2d1_1.h)

Ottiene la destinazione attualmente associata al contesto di dispositivo.

Sintassi

void GetTarget(
  [out, optional] ID2D1Image **image
);

Parametri

[out, optional] image

Tipo: ID2D1Image**

Quando termina, questo metodo contiene l'indirizzo di un puntatore alla destinazione attualmente associata al contesto di dispositivo.

Valore restituito

nessuno

Osservazioni

Se una destinazione non è associata al contesto di dispositivo, la destinazione conterrà NULL quando i metodi vengono restituiti.

Se la destinazione attualmente selezionata è una bitmap anziché un elenco di comandi, l'applicazione può accedere alle bitmap iniziali create usando uno dei metodi seguenti:

• CreateHwndRenderTarget
• CreateDxgiSurfaceRenderTarget
• CreateWicBitmapRenderTarget
• CreateDCRenderTarget
• CreateCompatibleRenderTarget

Non è possibile che un'applicazione elimini queste bitmap. Tutte queste bitmap sono associabili come destinazioni bitmap. Tuttavia, non tutte queste bitmap possono essere usate come origini bitmap per i metodi ID2D1RenderTarget .

CreateDxgiSurfaceRenderTarget creerà una bitmap utilizzabile come origine bitmap se la superficie DXGI è associabile come visualizzazione risorse shader.

CreateCompatibleRenderTarget creerà sempre bitmap utilizzabili come origine bitmap.

ID2D1RenderTarget::BeginDraw copia da HDC alla bitmap originale associata. ID2D1RenderTarget::EndDraw copia dalla bitmap originale in HDC.

Gli oggetti IWICBitmap verranno bloccati nelle circostanze seguenti:

• BeginDraw è stato chiamato e la bitmap di destinazione attualmente selezionata è una bitmap WIC.
• Una bitmap WIC viene impostata come destinazione di un contesto di dispositivo dopo che BeginDraw è stato chiamato e prima della chiamata di EndDraw.
• Qualsiasi metodo ID2D1Bitmap::Copy* viene chiamato con una bitmap WIC come origine o destinazione.

Gli oggetti IWICBitmap verranno sbloccati nelle circostanze seguenti:

• EndDraw viene chiamato e la bitmap di destinazione attualmente selezionata è una bitmap WIC.
• Una bitmap WIC viene rimossa come destinazione di un contesto di dispositivo tra le chiamate a BeginDraw e EndDraw.
• Qualsiasi metodo ID2D1Bitmap::Copy* viene chiamato con una bitmap WIC come origine o destinazione.

Direct2D bloccherà solo le bitmap che non sono attualmente bloccate.

La chiamata a QueryInterface per ID2D1GdiInteropRenderTarget avrà sempre esito positivo. ID2D1GdiInteropRenderTarget::GetDC restituirà un contesto di dispositivo corrispondente alla bitmap di destinazione attualmente associata. GetDC avrà esito negativo se la bitmap di destinazione non è stata creata con il flag GDI_COMPATIBLE impostato.

ID2D1HwndRenderTarget::Resize restituirà DXGI_ERROR_INVALID_CALL se sono presenti riferimenti in sospeso alla bitmap di destinazione originale associata alla destinazione di rendering.

Anche se la destinazione può essere un elenco di comandi, non può essere un altro tipo di immagine. Non può essere l'immagine di output di un effetto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e aggiornamento della piattaforma per Windows 7 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 e aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	d2d1_1.h
DLL	D2d1.dll

Vedi anche

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::SetTarget