DXGKDDI_VIDPNTARGETMODESET_ADDMODE funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

La funzione pfnAddMode aggiunge una modalità di destinazione VidPN a un oggetto impostato in modalità di destinazione VidPN specificato.

Sintassi

DXGKDDI_VIDPNTARGETMODESET_ADDMODE DxgkddiVidpntargetmodesetAddmode;

NTSTATUS DxgkddiVidpntargetmodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

Parametri

[in] hVidPnTargetModeSet

Handle a un oggetto set di modalità di destinazione VidPN. Il driver miniport visualizzato ottenuto in precedenza questo handle chiamando la funzione pfnAcquireTargetModeSet dell'interfaccia DXGK_VIDPN_INTERFACE .

[in] pVidPnTargetModeInfo

Puntatore a una struttura D3DKMDT_VIDPN_TARGET_MODE che descrive la modalità di destinazione. 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_TARGETMODESET	L'handle fornito in hVidPnTargetModeSet non è valido.

Commenti

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

Chiamare pfnCreateNewModeInfo per ottenere un puntatore a una struttura D3DKMDT_VIDPN_TARGET_MODE . La funzione pnfCreateNewModeInfo alloca la struttura e inserisce il membro ID con un identificatore della modalità di destinazione appena generato.
Il membro Info della struttura D3DKMDT_VIDPN_TARGET_MODE è una struttura D3DKMDT_VIDEO_SIGNAL_MODE . Popolare tale struttura con informazioni sulla modalità.
Chiamare pfnAddMode per aggiungere la modalità a un set di modalità di destinazione.

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

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

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