DXGKDDI_VIDPN_ACQUIRETARGETMODESET funzione di callback (d3dkmddi.h)

Articolo
05/26/2023

La funzione pfnAcquireTargetModeSet restituisce un handle a un oggetto set di modalità di destinazione specifico contenuto da un oggetto VidPN specificato.

Sintassi

DXGKDDI_VIDPN_ACQUIRETARGETMODESET DxgkddiVidpnAcquiretargetmodeset;

NTSTATUS DxgkddiVidpnAcquiretargetmodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phVidPnTargetModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterface
)
{...}

Parametri

[in] hVidPn

Handle per un oggetto VidPN. Il manager VidPN in precedenza ha fornito questo handle al driver miniport visualizzato chiamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.

[in] VidPnTargetId

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

[out] phVidPnTargetModeSet

Puntatore a una variabile che riceve un handle all'oggetto set di modalità di destinazione richiesto.

[out] ppVidPnTargetModeSetInterface

Puntatore a una variabile che riceve un puntatore a una struttura DXGK_VIDPNTARGETMODESET_INTERFACE . La struttura contiene puntatori alle funzioni che il driver miniport visualizzato può chiamare per controllare e modificare l'oggetto impostato in modalità di destinazione.

Valore restituito

La funzione pfnAcquireTargetModeSet restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Funzione completata.
STATUS_GRAPHICS_INVALID_VIDPN	L'handle fornito in hVidPn non è valido.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	L'identificatore specificato in VidPnTargetId non è valido.

Commenti

Gli identificatori di destinazione VidPN vengono assegnati dal driver miniport visualizzato. DxgkDdiQueryChildRelations, implementato dal driver miniport visualizzato, restituisce una matrice di strutture DXGK_CHILD_DESCRIPTOR , ognuna delle quali contiene un identificatore.

Al termine dell'uso dell'handle dell'oggetto set di modalità di destinazione, è necessario rilasciare l'handle chiamando pfnReleaseTargetModeSet. Gli oggetti set di modalità di destinazione vengono conteggiati, quindi, se si acquisisce un handle più volte, è necessario rilasciarlo con lo stesso numero di volte.

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

Il tipo di dati D3DDDI_VIDEO_PRESENT_TARGET_ID è definito in D3dukmdt.h.

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