DXGKDDI_VIDPN_ACQUIRETARGETMODESET funzione di callback (d3dkmddi.h)
La funzione pfnAcquireTargetModeSet restituisce un handle a un oggetto set di modalità di destinazione specifico contenuto in 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 di un oggetto VidPN. Il manager VidPN ha precedentemente fornito questo handle al driver miniport di visualizzazione chiamando DxgkDdiEnumVidPnCofuncModality, DxgkDdiIsSupportedVidPno DxgkDdiRecommendFunctionalVidPn.
[in] VidPnTargetId
Intero che identifica una delle destinazioni del video associate all'oggetto VidPN.
[out] phVidPnTargetModeSet
Puntatore a una variabile che riceve un handle per l'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 del miniport di visualizzazione può chiamare per esaminare e modificare l'oggetto impostato in modalità di destinazione.
Valore restituito
La funzione pfnAcquireTargetModeSet restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | La funzione ha avuto esito positivo. |
| STATUS_GRAPHICS_INVALID_VIDPN | L'handle fornito in hVidPn non è valido. |
| STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET | L'identificatore fornito in VidPnTargetId non è valido. |
Osservazioni
Gli identificatori di destinazione VidPN vengono assegnati dal driver miniport di visualizzazione. DxgkDdiQueryChildRelations, implementato dal driver miniport di visualizzazione, restituisce una matrice di strutture DXGK_CHILD_DESCRIPTOR, ognuna delle quali contiene un identificatore.
Al termine dell'uso dell'handle oggetto impostato in modalità di destinazione, è necessario rilasciare l'handle chiamando pfnReleaseTargetModeSet. Gli oggetti set in modalità di destinazione vengono conteggiati, quindi se si acquisisce un handle più volte, è necessario rilasciarlo nello 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 a 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |