Creación de una tabla de funciones virtuales para un controlador de flujo
[La característica asociada a esta página, Controladores personalizados de archivos y secuencias, es una característica heredada. Se ha reemplazado por la clase MediaStreamSource. La clase MediaStreamSource se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use la clase MediaStreamSource en lugar de los controladores de secuencias y archivos personalizados, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
En el ejemplo siguiente (escrito en C) se muestra cómo una aplicación (AVIBall) crea la tabla de funciones virtuales que se usa para hacer referencia a sus servicios.
HRESULT STDMETHODCALLTYPE AVIBallQueryInterface (PAVISTREAM ps,
REFIID riid, LPVOID FAR* ppvObj);
HRESULT STDMETHODCALLTYPE AVIBallCreate (PAVISTREAM ps,
LONG lParam1, LONG lParam2);
ULONG STDMETHODCALLTYPE AVIBallAddRef (PAVISTREAM ps);
ULONG STDMETHODCALLTYPE AVIBallRelease (PAVISTREAM ps);
HRESULT STDMETHODCALLTYPE AVIBallInfo (PAVISTREAM ps,
AVIStreamHeader FAR * psi, LONG lSize);
LONG STDMETHODCALLTYPE AVIBallFindSample (PAVISTREAM ps,
LONG lPos, LONG lFlags);
HRESULT STDMETHODCALLTYPE AVIBallReadFormat (PAVISTREAM ps,
LONG lPos, LPVOID lpFormat, LONG FAR *lpcbFormat);
HRESULT STDMETHODCALLTYPE AVIBallSetFormat (PAVISTREAM ps,
LONG lPos, LPVOID lpFormat, LONG cbFormat);
HRESULT STDMETHODCALLTYPE AVIBallRead (PAVISTREAM ps,
LONG lStart, LONG lSamples, LPVOID lpBuffer, LONG cbBuffer,
LONG FAR * plBytes,LONG FAR * plSamples);
HRESULT STDMETHODCALLTYPE AVIBallWrite (PAVISTREAM ps, LONG lStart,
LONG lSamples, LPVOID lpBuffer, LONG cbBuffer, DWORD dwFlags);
HRESULT STDMETHODCALLTYPE AVIBallDelete (PAVISTREAM ps,
LONG lStart, LONG lSamples);
HRESULT STDMETHODCALLTYPE AVIBallReadData (PAVISTREAM ps,
DWORD fcc, LPVOID lp,LONG FAR *lpcb);
HRESULT STDMETHODCALLTYPE AVIBallWriteData (PAVISTREAM ps,
DWORD fcc, LPVOID lp,LONG cb);
IAVIStreamVtbl AVIBallHandler = {
AVIBallQueryInterface, // Function pointer for ::QueryInterface
AVIBallAddRef, // Function pointer for ::AddRef
AVIBallRelease, // Function pointer for ::Release
AVIBallCreate, // Function pointer for ::Create
AVIBallInfo, // Function pointer for ::Info
AVIBallFindSample, // Function pointer for ::FindSample
AVIBallReadFormat, // Function pointer for ::ReadFormat
AVIBallSetFormat, // Function pointer for ::SetFormat
AVIBallRead, // Function pointer for ::Read
AVIBallWrite, // Function pointer for ::Write
AVIBallDelete, // Function pointer for ::Delete
AVIBallReadData, // Function pointer for ::ReadData
AVIBallWriteData // Function pointer for ::WriteData
};
Los controladores de archivos usan un procedimiento similar, excepto que usan una definición diferente para la tabla de funciones virtuales.