DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO funzione di callback (d3dkmddi.h)
La funzione pfnReleasePathInfo rilascia una struttura D3DKMDT_VIDPN_PRESENT_PATH fornita in precedenza dal gestore VidPN al driver miniport di visualizzazione.
Sintassi
DXGKDDI_VIDPNTOPOLOGY_RELEASEPATHINFO DxgkddiVidpntopologyReleasepathinfo;
NTSTATUS DxgkddiVidpntopologyReleasepathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_CONST_PD3DKMDT_VIDPN_PRESENT_PATH_CONST pVidPnPresentPathInfo
)
{...}
Parametri
[in] hVidPnTopology
Handle per un oggetto topologia VidPN. Il driver miniport di visualizzazione ottenuto in precedenza questo handle chiamando la funzione pfnGetTopology dell'interfaccia DXGK_VIDPN_INTERFACE .
[in] pVidPnPresentPathInfo
Puntatore alla struttura D3DKMDT_VIDPN_PRESENT_PATH che deve essere rilasciata.
Valore restituito
La funzione pfnReleasePathInfo restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | Funzione completata. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | L'handle fornito in hVidPnTopology non è valido. |
| STATUS_GRAPHICS_INVALID_VIDPN_PRESENT_PATH | Il puntatore fornito in pVidPnPresentPathInfo non è valido. |
Commenti
Al termine dell'uso di una struttura D3DKMDT_VIDPN_PRESENT_PATH ottenuta chiamando una delle funzioni seguenti, è necessario rilasciare la struttura chiamando pfnReleasePathInfo.
Se si ottiene una struttura D3DKMDT_VIDPN_PRESENT_PATH chiamando pfnCreateNewPathInfo e quindi passando tale struttura a pfnAddPath, non è necessario rilasciare la struttura.Se si ottiene un handle chiamando pfnCreateNewPathInfo e quindi si decide di non aggiungere il nuovo percorso a una topologia, è necessario rilasciare la struttura appena creata chiamando pfnReleasePathInfo.
Il tipo di dati D3DKMDT_HVIDPNTOPOLOGY è definito in D3dkmdt.h.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |