WindowsXP/multimedia/directx/dplay/tools/dp8sim/dp8sim_interface.txt
2025-04-27 07:49:33 -04:00

117 lines
2.5 KiB
Plaintext

IDP8SimControl interface
---------------------------------------------------------------------------
Currently, the IDP8SimControl interface is for internal purposes only. It
does not perform proper error checking. Here is preliminary documentation
on the supported functions.
IDP8SimControl::Initialize
Initializes the DP8Sim Control interface.
Parameters
DWORD dwFlags - Unused, must be 0.
IDP8SimControl::Close
Closes the DP8Sim Control interface.
Parameters
DWORD dwFlags - Unused, must be 0.
IDP8SimControl::EnableControlForSP
Inserts the DP8Sim Control shim in front of the SP with the given GUID.
Parameters
GUID * pguidSP - Pointer to GUID of SP to intercept.
WCHAR * wszNewFriendlyName - New friendly name for intercepted SP.
DWORD dwFlags - Unused, must be zero.
IDP8SimControl::DisableControlForSP
Removes the DP8Sim Control shim from the SP with the given GUID.
Parameters
GUID * pguidSP - Pointer to GUID of SP that should no longer be
intercepted.
DWORD dwFlags - Unused, must be zero.
IDP8SimControl::GetControlEnabledForSP
Determines whether the DP8Sim Control shim is enabled for the SP with the
given GUID or not. TRUE is returned in pfEnabled if so, FALSE if not.
Parameters
GUID * pguidSP - Pointer to GUID of SP that should be checked.
BOOL * pfEnabled - Place to store boolean indicating status.
DWORD dwFlags - Unused, must be zero.
IDP8SimControl::GetAllParameters
Retrieves all of the current DP8Sim settings.
Parameters
DP8SIM_PARAMETERS * pdp8spSend - Place to store current send
parameters.
DP8SIM_PARAMETERS * pdp8spReceive - Place to store current receive
parameters.
DWORD dwFlags - Unused, must be zero.
IDP8SimControl::SetAllParameters
Modifies the current DP8Sim settings.
Parameters
DP8SIM_PARAMETERS * pdp8spSend - Structure containing desired send
parameters.
DP8SIM_PARAMETERS * pdp8spReceive - Structure containing desired
receive parameters.
DWORD dwFlags - Unused, must be zero.
IDP8SimControl::GetAllStatistics
Retrieves all of the current DP8Sim statistics.
Parameters
DP8SIM_STATISTICS * pdp8ssSend - Place to store current send
statistics.
DP8SIM_STATISTICS * pdp8ssReceive - Place to store current receive
statistics.
DWORD dwFlags - Unused, must be zero.
IDP8SimControl::ClearAllStatistics
Clears all of the current DP8Sim statistics.
Parameters
DWORD dwFlags - Unused, must be zero.