DXGKDDI_VIDPN_CREATENEWSOURCEMODESET funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

La funzione pfnCreateNewSourceModeSet crea un nuovo oggetto set di 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 di un oggetto VidPN. Il manager VidPN ha precedentemente fornito questo handle al driver miniport di visualizzazione chiamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPno 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 del miniport di visualizzazione può chiamare per esaminare e modificare l'oggetto set in modalità di origine.

Valore restituito

La funzione pfnCreateNewSourceModeSet restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha avuto esito positivo.
STATUS_GRAPHICS_INVALID_VIDPN	L'handle fornito in hVidPn non è valido.
STATUS_NO_MEMORY	Gestione VidPN non è riuscito ad allocare la memoria necessaria per creare il nuovo oggetto impostato in modalità di origine.

Osservazioni

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

Chiamare pfnCreateNewSourceModeSet per ottenere un handle a un nuovo oggetto impostato in modalità di origine. L'oggetto set in modalità di origine appartiene a un particolare oggetto VidPN specificato.
Usare le funzioni dell'interfaccia DXGK_VIDPNSOURCEMODESET_INTERFACE per aggiungere modalità all'oggetto set in 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 passare 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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
piattaforma di destinazione	Desktop
intestazione	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

Vedere anche

dell'interfaccia set in modalità origine VidPN

pfnAssignSourceModeSet

pfnReleaseSourceModeSet

Condividi tramite