diff --git a/include/Makefile.in b/include/Makefile.in index 8d6d6cf7b4e..462918082f3 100644 --- a/include/Makefile.in +++ b/include/Makefile.in @@ -120,6 +120,7 @@ WINDOWS_INCLUDES = \ dplay8.h \ dplobby.h \ dplobby8.h \ + dpnathlp.h \ dsconf.h \ dsdriver.h \ dshow.h \ diff --git a/include/dpnathlp.h b/include/dpnathlp.h new file mode 100644 index 00000000000..c31a3da01f4 --- /dev/null +++ b/include/dpnathlp.h @@ -0,0 +1,190 @@ +/* + * Copyright (C) 2006 Maarten Lankhorst + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2.1 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ + +#ifndef __DPNATHLP_H__ +#define __DPNATHLP_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +HRESULT DirectPlayNATHelpCreate(const PGUID pIID, void ** ppvInterface); + +DEFINE_GUID(CLSID_DirectPlayNATHelpUPnP, 0xb9c2e9c4,0x68c1,0x4d42,0xa7,0xa1,0xe7,0x6a,0x26,0x98,0x2a,0xd6); +DEFINE_GUID(CLSID_DirectPlayNATHelpPAST, 0x963ab779,0x16a1,0x477c,0xa3,0x6d,0xcb,0x5e,0x71,0x19,0x38,0xf7); +DEFINE_GUID(IID_IDirectPlayNATHelp, 0x154940b6,0x2278,0x4a2f,0x91,0x01,0x9b,0xa9,0xf4,0x31,0xf6,0x03); + +#define DPNHGETCAPS_UPDATESERVERSTATUS 0x01 + +#define DPNHREGISTERPORTS_TCP 0x01 +#define DPNHREGISTERPORTS_FIXEDPORTS 0x02 +#define DPNHREGISTERPORTS_SHAREDPORTS 0x04 + +#define DPNHADDRESSTYPE_TCP 0x01 +#define DPNHADDRESSTYPE_FIXEDPORTS 0x02 +#define DPNHADDRESSTYPE_SHAREDPORTS 0x04 +#define DPNHADDRESSTYPE_LOCALFIREWALL 0x08 +#define DPNHADDRESSTYPE_GATEWAY 0x10 +#define DPNHADDRESSTYPE_GATEWAYISLOCAL 0x20 + +#define DPNHCAPSFLAG_LOCALFIREWALLPRESENT 0x01 +#define DPNHCAPSFLAG_GATEWAYPRESENT 0x02 +#define DPNHCAPSFLAG_GATEWAYISLOCAL 0x04 +#define DPNHCAPSFLAG_PUBLICADDRESSAVAILABLE 0x08 +#define DPNHCAPSFLAG_NOTALLSUPPORTACTIVENOTIFY 0x10 + +#define DPNHINITIALIZE_DISABLEGATEWAYSUPPORT 0x01 +#define DPNHINITIALIZE_DISABLELOCALFIREWALLSUPPORT 0x02 + +#define DPNHQUERYADDRESS_TCP 0x01 +#define DPNHQUERYADDRESS_CACHEFOUND 0x02 +#define DPNHQUERYADDRESS_CACHENOTFOUND 0x04 +#define DPNHQUERYADDRESS_CHECKFORPRIVATEBUTUNMAPPED 0x08 + +#define DPNHGETREGISTEREDADDRESSES_LOCALFIREWALLREMAPONLY 0x01 + +#define _DPNH_FACILITY_CODE 0x015 +#define _DPNH_HRESULT_BASE 0xF000 + +#define MAKE_DPNHSUCCESS(code) \ + MAKE_HRESULT(0, _DPNH_FACILITY_CODE, (code + _DPNH_HRESULT_BASE)) +#define MAKE_DPNHFAILURE(code) \ + MAKE_HRESULT(1, _DPNH_FACILITY_CODE, (code + _DPNH_HRESULT_BASE)) + +#define DPNH_OK S_OK +#define DPNHSUCCESS_ADDRESSESCHANGED MAKE_DPNHSUCCESS(0x10) + +#define DPNHERR_ALREADYINITIALIZED MAKE_DPNHFAILURE(0x10) +#define DPNHERR_BUFFERTOOSMALL MAKE_DPNHFAILURE(0x20) +#define DPNHERR_GENERIC E_FAIL +#define DPNHERR_INVALIDFLAGS MAKE_DPNHFAILURE(0x30) +#define DPNHERR_INVALIDOBJECT MAKE_DPNHFAILURE(0x40) +#define DPNHERR_INVALIDPARAM E_INVALIDARG +#define DPNHERR_INVALIDPOINTER E_POINTER +#define DPNHERR_NOMAPPING MAKE_DPNHFAILURE(0x50) +#define DPNHERR_NOMAPPINGBUTPRIVATE MAKE_DPNHFAILURE(0x60) +#define DPNHERR_NOTINITIALIZED MAKE_DPNHFAILURE(0x70) +#define DPNHERR_OUTOFMEMORY E_OUTOFMEMORY +#define DPNHERR_PORTALREADYREGISTERED MAKE_DPNHFAILURE(0x80) +#define DPNHERR_PORTUNAVAILABLE MAKE_DPNHFAILURE(0x90) +#define DPNHERR_REENTRANT MAKE_DPNHFAILURE(0x95) +#define DPNHERR_SERVERNOTAVAILABLE MAKE_DPNHFAILURE(0xA0) +#define DPNHERR_UPDATESERVERSTATUS MAKE_DPNHFAILURE(0xC0) + +typedef DWORD_PTR DPNHHANDLE; +typedef DWORD_PTR *PDPNHHANDLE; + +typedef struct _DPNHCAPS +{ + DWORD dwSize; + DWORD dwFlags; + DWORD dwNumRegisteredPorts; + DWORD dwMinLeaseTimeRemaining; + DWORD dwRecommendedGetCapsInterval; +} DPNHCAPS, *PDPNHCAPS; + + +#define INTERFACE IDirectPlayNATHelp +DECLARE_INTERFACE_(IDirectPlayNATHelp,IUnknown) +{ + /*** IUnknown methods ***/ + STDMETHOD(QueryInterface) (THIS_ + REFIID riid, + void** ppvObject) PURE; + + STDMETHOD_(ULONG,AddRef) (THIS) PURE; + + STDMETHOD_(ULONG,Release) (THIS) PURE; + + /*** IDirectPlayNATHelp functions ***/ + STDMETHOD(Initialize) (THIS_ + const DWORD dwFlags) PURE; + + STDMETHOD(Close) (THIS_ + const DWORD dwFlags) PURE; + + STDMETHOD(GetCaps) (THIS_ + const PDPNHCAPS pCaps, + const DWORD dwFlags) PURE; + + STDMETHOD(RegisterPorts) (THIS_ + const PSOCKADDR aLocalAddresses, + const DWORD dwAddressSize, + const DWORD dwAddresses, + const DWORD dwTime, + const PDPNHHANDLE phRegisteredPorts, + const DWORD dwFlags) PURE; + + STDMETHOD(GetRegisteredAddresses) (THIS_ + const PDPNHHANDLE hRegisteredPorts, + const PSOCKADDR paPublicAddresses, + const DWORD *dwAddressSize, + const DWORD *dwAddressFlags, + const DWORD *dwRemaining, + const DWORD dwFlags) PURE; + + STDMETHOD(DeregisterPorts)(THIS_ + const DPNHHANDLE hRegPorts, + const DWORD dwFlags) PURE; + + STDMETHOD(QueryAddress) (THIS_ + const PSOCKADDR pSource, + const PSOCKADDR pQuery, + const PSOCKADDR pResponse, + const INT iAddresses, + const DWORD dwFlags) PURE; + + STDMETHOD(SetAlertEvent) (THIS_ + const HANDLE hEvent, + const DWORD dwFlags) PURE; + + STDMETHOD(SetAlertIOCompletionPort)(THIS_ + const HANDLE hIOCompletionPort, + const DWORD dwCompletion, + const DWORD dwMaxThreads, + const DWORD dwFlags) PURE; + + STDMETHOD(ExtendRegisteredPortsLease)(THIS_ + const DPNHHANDLE hRegisteredPorts, + const DWORD dwLeaseTime, + const DWORD dwFlags) PURE; +}; + +#undef INTERFACE + +#ifdef COBJMACROS +#define IDirectPlayNATHelp_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b) +#define IDirectPlayNATHelp_AddRef(p) (p)->lpVtbl->AddRef(p) +#define IDirectPlayNATHelp_Release(p) (p)->lpVtbl->Release(p) +#define IDirectPlayNATHelp_Initialize(p,a) (p)->lpVtbl->Initialize(p,a) +#define IDirectPlayNATHelp_Close(p,a) (p)->lpVtbl->Close(p,a) +#define IDirectPlayNATHelp_GetCaps(p,a,b) (p)->lpVtbl->GetCaps(p,a,b) +#define IDirectPlayNATHelp_RegisterPorts(p,a,b,c,d,e,f) (p)->lpVtbl->RegisterPorts(p,a,b,c,d,e,f) +#define IDirectPlayNATHelp_GetRegisteredAddresses(p,a,b,c,d,e,f) (p)->lpVtbl->GetRegisteredAddresses(p,a,b,c,d,e,f) +#define IDirectPlayNATHelp_DeregisterPorts(p,a,b) (p)->lpVtbl->DeregisterPorts(p,a,b) +#define IDirectPlayNATHelp_QueryAddress(p,a,b,c,d,e) (p)->lpVtbl->QueryAddress(p,a,b,c,d,e) +#define IDirectPlayNATHelp_SetAlertEvent(p,a,b) (p)->lpVtbl->SetAlertEvent(p,a,b) +#define IDirectPlayNATHelp_SetAlertIOCompletionPort(p,a,b,c,d) (p)->lpVtbl->SetAlertIOCompletionPort(p,a,b,c,d) +#define IDirectPlayNATHelp_ExtendRegisteredPortsLease(p,a,b,c) (p)->lpVtbl->SetAlertIOCompletionPort(p,a,b,c) +#endif + +#ifdef __cplusplus +} +#endif + +#endif /* __DPNATHLP_H__ */