DXGKDDI_VIDPN_CREATENEWTARGETMODESET funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

La funzione pfnCreateNewTargetModeSet crea un nuovo oggetto set di modalità di destinazione all'interno di un oggetto VidPN specificato.

Sintassi

DXGKDDI_VIDPN_CREATENEWTARGETMODESET DxgkddiVidpnCreatenewtargetmodeset;

NTSTATUS DxgkddiVidpnCreatenewtargetmodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phNewVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterace
)
{...}

Parametri

[in] hVidPn

Handle per un oggetto VidPN. Il manager VidPN in precedenza ha fornito questo handle al driver miniport visualizzato chiamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.

[in] VidPnTargetId

Intero che identifica una delle destinazioni del video presenti associate all'oggetto VidPN.

[out] phNewVidPnTargetModeSet

Puntatore a una variabile che riceve un handle all'oggetto set di modalità di destinazione appena creato.

[out] ppVidPnTargetModeSetInterace

Puntatore a una variabile che riceve un puntatore a una struttura DXGK_VIDPNTARGETMODESET_INTERFACE . La struttura contiene puntatori alle funzioni che il driver miniport visualizzato può chiamare per controllare e modificare l'oggetto impostato in modalità di destinazione.

Valore restituito

La funzione pfnCreateNewTargetModeSet restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Funzione completata.
STATUS_GRAPHICS_INVALID_VIDPN	L'handle fornito in hVidPn non è valido.
STATUS_NO_MEMORY	Il gestore VidPN non è riuscito a allocare la memoria necessaria per creare il nuovo oggetto impostato in modalità di destinazione.

Commenti

Per assegnare una nuova modalità di destinazione impostata su una determinata destinazione in un'implementazione VidPN, seguire questa procedura:

Chiamare pfnCreateNewTargetModeSet per ottenere un handle in un nuovo oggetto set di modalità di destinazione. Tale oggetto set di modalità di destinazione appartiene a un particolare oggetto VidPN specificato.
Usare le funzioni della struttura DXGK_VIDPNTARGETMODESET_INTERFACE per aggiungere modalità all'oggetto set di modalità di destinazione.
Chiamare pfnAssignTargetModeSet per assegnare la nuova modalità di destinazione impostata su una determinata destinazione.

Se si ottiene un handle chiamando pfnCreateNewTargetModeSet e quindi passare tale handle a pfnAssignTargetModeSet, non è necessario rilasciare l'handle chiamando pfnReleaseTargetModeSet.

Se si ottiene un handle chiamando pfnCreateNewTargetModeSet e quindi si decide di non assegnare la nuova modalità di destinazione impostata su una destinazione, è necessario rilasciare l'handle appena ottenuto chiamando pfnReleaseTargetModeSet.

La durata della struttura DXGK_VIDPNTARGETEMODESET_INTERFACE restituita in ppVidPnTargetModeSetInterface è di proprietà del sistema operativo. Usando questo schema di proprietà, il sistema operativo può passare alle implementazioni più recenti in fase di esecuzione senza interrompere i client dell'interfaccia.

I tipi di dati D3DKMDT_HVIDPN e D3DKMDT_HVIDPNTARGETMODESET sono definiti in D3dkmdt.h.