DXGKDDI_VIDPN_ACQUIRESOURCEMODESET funzione di callback (d3dkmddi.h)

Articolo
05/26/2023

La funzione pfnAcquireSourceModeSet restituisce un handle a un oggetto set di modalità di origine specifico contenuto in un oggetto VidPN specificato.

Sintassi

DXGKDDI_VIDPN_ACQUIRESOURCEMODESET DxgkddiVidpnAcquiresourcemodeset;

NTSTATUS DxgkddiVidpnAcquiresourcemodeset(
  [in]  IN_CONST_D3DKMDT_HVIDPN hVidPn,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId,
  [out] OUT_PD3DKMDT_HVIDPNSOURCEMODESET phVidPnSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_VIDPNSOURCEMODESET_INTERFACE ppVidPnSourceModeSetInterface
)
{...}

Parametri

[in] hVidPn

Handle per un oggetto VidPN. Il manager VidPN ha precedentemente fornito questo handle al driver miniport di visualizzazione chiamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPn o DxgkDdiRecommendFunctionalVidPn.

[in] VidPnSourceId

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

[out] phVidPnSourceModeSet

Puntatore a una variabile che riceve un handle per l'oggetto set di modalità di origine richiesto.

[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 miniport di visualizzazione può chiamare per ispezionare e modificare l'oggetto set di modalità di origine.

Valore restituito

La funzione pfnAcquireSourceModeSet 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_SOURCE	L'identificatore specificato in VidPnSourceId non è valido.

Commenti

Gli identificatori di origine VidPN vengono assegnati dal sistema operativo. DxgkDdiStartDevice, implementato dal driver miniport di visualizzazione, restituisce il numero N di origini video presenti supportate dalla scheda di visualizzazione. Il sistema operativo assegna quindi gli identificatori 0, 1, 2, ... N - 1.

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

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.

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

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