DXGKDDI_VIDPN_CREATENEWSOURCEMODESET funzione di callback (d3dkmddi.h)

Articolo
05/26/2023

La funzione pfnCreateNewSourceModeSet crea un nuovo oggetto set in modalità di origine all'interno di un oggetto VidPN specificato.

Sintassi

DXGKDDI_VIDPN_CREATENEWSOURCEMODESET DxgkddiVidpnCreatenewsourcemodeset;

NTSTATUS DxgkddiVidpnCreatenewsourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phNewVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}

Parametri

[in] hVidPn

Handle per un oggetto VidPN. Il manager VidPN ha precedentemente fornito questo handle al driver miniport di visualizzazione chiamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.

[in] VidPnSourceId

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

[out] phNewVidPnSourceModeSet

Puntatore a una variabile che riceve un handle per l'oggetto set di modalità di origine appena creato.

[out] ppVidPnSourceModeSetInterface

Puntatore a una variabile che riceve un puntatore a una struttura DXGK_VIDPNSOURCEMODESET_INTERFACE . La struttura contiene puntatori alle funzioni che il driver miniport di visualizzazione può chiamare per ispezionare e modificare l'oggetto set di modalità di origine.

Valore restituito

La funzione pfnCreateNewSourceModeSet 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 ad allocare la memoria necessaria per creare il nuovo oggetto set di modalità di origine.

Commenti

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

Chiamare pfnCreateNewSourceModeSet per ottenere un handle in un nuovo oggetto set in modalità di origine. Tale oggetto set di modalità di origine appartiene a un particolare oggetto VidPN specificato.
Usare le funzioni dell'interfaccia DXGK_VIDPNSOURCEMODESET_INTERFACE per aggiungere modalità all'oggetto set di modalità di origine.
Chiamare pfnAssignSourceModeSet per assegnare la nuova modalità di origine impostata su una determinata origine.

Se si ottiene un handle chiamando pfnCreateNewSourceModeSet e quindi passando tale handle a pfnAssignSourceModeSet, non è necessario rilasciare l'handle chiamando pfnReleaseSourceModeSet.

Se si ottiene un handle chiamando pfnCreateNewSourceModeSet e quindi si decide di non assegnare la nuova modalità di origine impostata su un'origine, è necessario rilasciare l'handle appena ottenuto chiamando pfnReleaseSourceModeSet.

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

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