Metodo IAMDevMemoryAllocator::GetDevMemoryObject (strmif.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Sintassi
HRESULT GetDevMemoryObject(
[out] IUnknown **ppUnkInnner,
[in] IUnknown *pUnkOuter
);
Parametri
[out] ppUnkInnner
Indirizzo di un puntatore al proprio IUnknown dell'oggetto controllo appena creato. Questa interfaccia IUnknown interna deve essere rilasciata quando l'oggetto esterno viene eliminato definitivamente. L'allocatore personalizzato deve chiamare il metodo QueryInterface su questo puntatore per ottenere l'interfaccia IAMDevMemoryControl .
[in] pUnkOuter
Puntatore alla propria interfaccia IUnknown dell'allocatore personalizzato. Questa interfaccia aggrega l'oggetto controllo memoria del dispositivo all'interno dell'allocatore personalizzato.
Valore restituito
Restituisce un valore HRESULT .
Commenti
L'oggetto controllo memoria del dispositivo è necessario per aggregare con l'allocatore personalizzato, perché i renderer che richiedono l'uso della memoria su scheda eseguiranno una query per IAMDevMemoryControl quando ricevono un nuovo allocatore, per verificare che la memoria provengano dallo stesso dispositivo. Ciò si verifica perché il filtro hardware riceverà un oggetto IMemAllocator , che potrebbe o meno usare la memoria su scheda. Per decidere se si tratta di un allocatore compatibile, l'oggetto esegue una query per l'interfaccia IAMDevMemoryControl per accedere a metodi specifici. IAMDevMemoryControl crea un oggetto aggregato che implementa i metodi di IAMDevMemoryControl (spesso specifici dell'hardware).
Vedere la documentazione COM per informazioni sulle modalità di implementazione dell'aggregazione da parte dell'oggetto esterno.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |