DXGKDDI_VIDPNSOURCEMODESET_ADDMODE funzione di callback (d3dkmddi.h)

Articolo
02/06/2025

La funzione pfnAddMode aggiunge una modalità di origine VidPN a un oggetto set di modalità di origine VidPN specificato.

Sintassi

DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;

NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

Parametri

[in] hVidPnSourceModeSet

Handle per un oggetto set di modalità di origine VidPN. Il driver miniport di visualizzazione ottenuto in precedenza questo handle chiamando il pfnAcquireSourceModeSet funzione dell'interfaccia DXGK_VIDPN_INTERFACE.

[in] pVidPnSourceModeInfo

Puntatore a una struttura D3DKMDT_VIDPN_SOURCE_MODE che descrive la modalità di origine. Il driver miniport di visualizzazione ottenuto in precedenza questa struttura chiamando pfnCreateNewModeInfo.

Valore restituito

La funzione pfnAddMode restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha avuto esito positivo.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	L'handle fornito in hVidPnSourceModeSet non è valido.

Osservazioni

Per aggiungere una modalità a un set di modalità di origine, il driver miniport di visualizzazione esegue i passaggi seguenti.

Chiamare pfnCreateNewModeInfo per ottenere un puntatore a una struttura D3DKMDT_VIDPN_SOURCE_MODE. La funzione pnfCreateNewModeInfo alloca la struttura, inserisce il membro id con un identificatore di modalità di origine appena generato e imposta il membro type su D3DKMDT_RMT_UNINITIALIZED.

Popolare la struttura D3DKMDT_VIDPN_SOURCE_MODE (ad eccezione del membro id ) con informazioni sulla modalità, incluso il tipo e il formato della modalità.

Chiamare pfnAddMode per aggiungere la modalità a un set di modalità di origine.

Il responsabile VidPN alloca una struttura di D3DKMDT_VIDPN_SOURCE_MODE quando si chiama pfnCreateNewModeInfo. Se si aggiunge la modalità descritta da tale struttura a un set di modalità di origine, non è necessario rilasciare in modo esplicito la struttura; pfnAddMode la rilascia.

Se si ottiene una struttura D3DKMDT_VIDPN_SOURCE_MODE chiamando pfnCreateNewModeInfo e quindi si decide di non aggiungere tale modalità a un set di modalità di origine, è necessario rilasciare in modo esplicito la struttura chiamando pfnReleaseModeInfo.

Il tipo di dati D3DKMDT_HVIDPNSOURCEMODESET è definito in D3dkmdt.h.