Merge pull request #5 from Fire-Head/master

skeleton updated, windows specific stuff added

1 files changed, 172 insertions, 0 deletions

diff --git a/dxsdk/Include/DShowIDL/Videoacc.idl b/dxsdk/Include/DShowIDL/Videoacc.idl
new file mode 100644
index 00000000..6c55aa73
--- /dev/null
+++ b/dxsdk/Include/DShowIDL/Videoacc.idl
@@ -0,0 +1,172 @@
+//------------------------------------------------------------------------------
+// File: VideoAcc.idl
+//
+// Desc: An interface exposed by the overlay mixer to help decode samples
+//       using hardware video acceleration.
+//
+// Copyright (c) 1992-2002, Microsoft Corporation.  All rights reserved.
+//------------------------------------------------------------------------------
+
+
+import "unknwn.idl";
+
+cpp_quote("//")
+cpp_quote("//   The following declarations within the 'if 0' block are dummy typedefs used to make")
+cpp_quote("//   the motncomp.idl file build.  The actual definitions are contained in ddraw.h and amva.h")
+cpp_quote("//")
+cpp_quote("#if 0")
+
+typedef void*       LPVOID;
+typedef void*       LPGUID;
+typedef void*       LPDIRECTDRAWSURFACE;
+typedef void*       LPDDPIXELFORMAT;
+typedef void*       LPAMVAInternalMemInfo;
+typedef void        AMVAUncompDataInfo;
+typedef void*       LPAMVACompBufferInfo;
+typedef void        AMVABUFFERINFO;
+typedef void        AMVAEndFrameInfo;
+typedef void*       LPAMVAUncompBufferInfo;
+typedef void        AMVABeginFrameInfo;
+typedef IUnknown*   IMediaSample;
+
+cpp_quote("#endif")
+cpp_quote("#include <ddraw.h>")
+cpp_quote("#include <amva.h>")
+
+
+[
+    local,
+    object,
+    uuid(256A6A21-FBAD-11d1-82BF-00A0C9696C8F),
+    helpstring("IAMVideoAcceleratorNotify Interface"),
+    pointer_default(unique)
+]
+
+// IAMVideoAcceleratorNotify
+interface IAMVideoAcceleratorNotify : IUnknown
+{
+    // get information necessary to allocate uncompressed data buffers
+    // which is not part of the mediatype format (like how many buffers to allocate etc)
+    HRESULT GetUncompSurfacesInfo([in] const GUID *pGuid, [in] [out] LPAMVAUncompBufferInfo pUncompBufferInfo);
+
+    // set information regarding allocated uncompressed data buffers
+    HRESULT SetUncompSurfacesInfo([in] DWORD dwActualUncompSurfacesAllocated);
+
+    // get information necessary to create video accelerator object. It is the caller's responsibility
+    // to call CoTaskMemFree() on *ppMiscData
+    HRESULT GetCreateVideoAcceleratorData([in] const GUID *pGuid, [out] LPDWORD pdwSizeMiscData, [out] LPVOID *ppMiscData);
+};
+
+[
+    local,
+    object,
+    uuid(256A6A22-FBAD-11d1-82BF-00A0C9696C8F),
+    helpstring("IAMVideoAccelerator Interface"),
+    pointer_default(unique)
+]
+
+// IAMVideoAccelerator
+interface IAMVideoAccelerator : IUnknown
+{
+    // pdwNumGuidsSupported is an IN OUT paramter
+    // pGuidsSupported is an IN OUT paramter
+    // if pGuidsSupported is NULL,  pdwNumGuidsSupported should return back with the
+    // number of uncompressed pixel formats supported
+    // Otherwise pGuidsSupported is an array of *pdwNumGuidsSupported structures
+    HRESULT GetVideoAcceleratorGUIDs([in] [out] LPDWORD pdwNumGuidsSupported, [in] [out] LPGUID pGuidsSupported);
+
+    // pGuid is an IN parameter
+    // pdwNumFormatsSupported is an IN OUT paramter
+    // pFormatsSupported is an IN OUT paramter (caller should make sure to set the size of EACH struct)
+    // if pFormatsSupported is NULL,  pdwNumFormatsSupported should return back with
+    // the number of uncompressed pixel formats supported
+    // Otherwise pFormatsSupported is an array of *pdwNumFormatsSupported structures
+    HRESULT GetUncompFormatsSupported( [in] const GUID *pGuid, [in] [out] LPDWORD pdwNumFormatsSupported,
+        [in] [out] LPDDPIXELFORMAT pFormatsSupported);
+
+    // pGuid is an IN parameter
+    // pamvaUncompDataInfo is an IN parameter
+    // pamvaInternalMemInfo is an IN OUT parameter (caller should make sure to set the size of struct)
+    // currently only gets info about how much scratch memory will the hal allocate for its private use
+    HRESULT GetInternalMemInfo([in] const GUID *pGuid, [in] const AMVAUncompDataInfo *pamvaUncompDataInfo,
+        [in] [out] LPAMVAInternalMemInfo pamvaInternalMemInfo);
+
+    // pGuid is an IN parameter
+    // pamvaUncompDataInfo is an IN parameter
+    // pdwNumTypesCompBuffers is an IN OUT paramter
+    // pamvaCompBufferInfo is an IN OUT paramter (caller should make sure to set the size of EACH struct)
+    // if pamvaCompBufferInfo is NULL,  pdwNumTypesCompBuffers should return back with the number of types of
+    // compressed buffers
+    // Otherwise pamvaCompBufferInfo is an array of *pdwNumTypesCompBuffers structures
+    HRESULT GetCompBufferInfo([in] const GUID *pGuid, [in] const AMVAUncompDataInfo *pamvaUncompDataInfo,
+        [in] [out] LPDWORD pdwNumTypesCompBuffers, [out] LPAMVACompBufferInfo pamvaCompBufferInfo);
+
+
+    // pdwNumTypesCompBuffers is an IN OUT paramter
+    // pamvaCompBufferInfo is an IN OUT paramter (caller should make sure to set the size of EACH struct)
+    // if pamvaCompBufferInfo is NULL,  pdwNumTypesCompBuffers should return back with the number of types of
+    // compressed buffers
+    // Otherwise pamvaCompBufferInfo is an array of *pdwNumTypesCompBuffers structures
+    // only valid to call this after the pins are connected
+    HRESULT GetInternalCompBufferInfo([in] [out] LPDWORD pdwNumTypesCompBuffers, [out] LPAMVACompBufferInfo pamvaCompBufferInfo);
+
+    // begin a frame, the pMiscData is passed directly to the hal
+    // only valid to call this after the pins are connected
+    // Tells the ovmixer which frame is the destination
+    // frame. Use indices (valid vales are [0 .. pdwNumSurfacesAllocated-1]) to specify frames
+    HRESULT BeginFrame([in] const AMVABeginFrameInfo *amvaBeginFrameInfo);
+
+    // end a frame, the pMiscData is passed directly to the hal
+    // only valid to call this after the pins are connected
+    HRESULT EndFrame([in] const AMVAEndFrameInfo *pEndFrameInfo);
+
+    // lock and obtain access to a single buffer
+    // only valid to call this after the pins are connected
+    // Buffers are identified by type and index within that type
+    // Specifiying read-only will allow access to busy reference
+    // frames
+    // Output (uncompressed) frames use a type index of 0xFFFFFFFF
+    HRESULT GetBuffer(
+        [in] DWORD dwTypeIndex,
+        [in] DWORD dwBufferIndex,
+        [in] BOOL bReadOnly,
+        [out] LPVOID *ppBuffer,
+        [out] LONG *lpStride);
+
+    // unlock a single buffer
+    // Buffers are identified by type and index within that type
+    // only valid to call this after the pins are connected
+    HRESULT ReleaseBuffer([in] DWORD dwTypeIndex, [in] DWORD dwBufferIndex);
+
+    // Perform a decompression operation
+    // Private data can be passed to and from a driver
+    // identifiers for the corresponding members of pamvaMacroBlockInfo
+    // pamvaMacroBlockInfo is an IN parameter which is array (of length dwNumBlocks) of structures
+    // only valid to call this after the pins are connected
+    HRESULT Execute(
+        [in] DWORD dwFunction,
+        [in] LPVOID lpPrivateInputData,
+        [in] DWORD cbPrivateInputData,
+        [in] LPVOID lpPrivateOutputDat,
+        [in] DWORD cbPrivateOutputData,
+        [in] DWORD dwNumBuffers,
+        [in] const AMVABUFFERINFO *pamvaBufferInfo);
+
+    // query the decode status of a particular decompression operation
+    // dwTypeIndex and dwBufferIndex define the buffer whose status is
+    // being queried
+    HRESULT QueryRenderStatus([in] DWORD dwTypeIndex,
+                              [in] DWORD dwBufferIndex,
+                              [in] DWORD dwFlags);
+
+    // display a frame. The mediasample contains the timestamps etc for the frame to be displayed
+    // this call is a non-blocking call
+    // only valid to call this after the pins are connected
+    HRESULT DisplayFrame([in] DWORD dwFlipToIndex, [in] IMediaSample *pMediaSample);
+};
+
+
+
+
+
+