DXGKDDI_VIDPN_CREATENEWTARGETMODESET funzione di callback (d3dkmddi.h)
La funzione pfnCreateNewTargetModeSet crea un nuovo oggetto set di modalità di destinazione all'interno di un oggetto VidPN specificato.
Sintassi
DXGKDDI_VIDPN_CREATENEWTARGETMODESET DxgkddiVidpnCreatenewtargetmodeset;
NTSTATUS DxgkddiVidpnCreatenewtargetmodeset(
[in] IN_CONST_D3DKMDT_HVIDPN hVidPn,
[in] IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
[out] OUT_PD3DKMDT_HVIDPNTARGETMODESET phNewVidPnTargetModeSet,
[out] DEREF_OUT_CONST_PPDXGK_VIDPNTARGETMODESET_INTERFACE ppVidPnTargetModeSetInterace
)
{...}
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] phNewVidPnTargetModeSet
Puntatore a una variabile che riceve un handle all'oggetto set di modalità di destinazione appena creato.
[out] ppVidPnTargetModeSetInterace
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 pfnCreateNewTargetModeSet restituisce uno dei valori seguenti:
Codice restituito | Descrizione |
---|---|
STATUS_SUCCESS | Funzione completata. |
STATUS_GRAPHICS_INVALID_VIDPN | L'handle fornito in hVidPn non è valido. |
STATUS_NO_MEMORY | Il gestore VidPN non è riuscito a allocare la memoria necessaria per creare il nuovo oggetto impostato in modalità di destinazione. |
Commenti
Per assegnare una nuova modalità di destinazione impostata su una determinata destinazione in un'implementazione VidPN, seguire questa procedura:
- Chiamare pfnCreateNewTargetModeSet per ottenere un handle in un nuovo oggetto set di modalità di destinazione. Tale oggetto set di modalità di destinazione appartiene a un particolare oggetto VidPN specificato.
- Usare le funzioni della struttura DXGK_VIDPNTARGETMODESET_INTERFACE per aggiungere modalità all'oggetto set di modalità di destinazione.
- Chiamare pfnAssignTargetModeSet per assegnare la nuova modalità di destinazione impostata su una determinata destinazione.
Se si ottiene un handle chiamando pfnCreateNewTargetModeSet e quindi si decide di non assegnare la nuova modalità di destinazione impostata su una destinazione, è necessario rilasciare l'handle appena ottenuto chiamando pfnReleaseTargetModeSet.
La durata della struttura DXGK_VIDPNTARGETEMODESET_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.
I tipi di dati D3DKMDT_HVIDPN e D3DKMDT_HVIDPNTARGETMODESET sono definiti in D3dkmdt.h.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista |
Piattaforma di destinazione | Desktop |
Intestazione | d3dkmddi.h (include D3dkmddi.h) |
IRQL | PASSIVE_LEVEL |
Vedi anche
Interfaccia del set di impostazioni della modalità di destinazione VidPN