DXGKDDI_VIDPNSOURCEMODESET_ADDMODE funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

La funzione pfnAddMode aggiunge una modalità di origine VidPN a un oggetto impostato in 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 visualizzato ottenuto in precedenza questo handle chiamando la funzione pfnAcquireSourceModeSet dell'interfaccia DXGK_VIDPN_INTERFACE .

[in] pVidPnSourceModeInfo

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

Valore restituito

La funzione pfnAddMode restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Funzione completata.
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	L'handle fornito in hVidPnSourceModeSet non è valido.

Commenti

Per aggiungere una modalità a un set di modalità di origine, il driver miniport visualizzato esegue la procedura seguente.

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 della modalità di origine appena generata 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 manager VidPN alloca una struttura 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 decidere 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.