TchPdd_Init (Compact 2013)

3/26/2014

This function initializes the PDD and the touch screen, and provides pointers to the other DDSI functions.

Syntax

DWORD WINAPI TchPdd_Init(
  LPCTSTR pszActiveKey,
  TCH_MDD_INTERFACE_INFO *pMddIfc,
  TCH_PDD_INTERFACE_INFO *pPddIfc,
  DWORD hMddContext
);

Parameters

  • pszActiveKey
    [in] Pointer to a string containing the registry path to the active key for the touch driver.
  • pPddIfc
    [out] Pointer to a TCH_PDD_INTERFACE_INFO structure that TchPdd_Init uses to return information about the other DDSI functions.
  • hMddContext
    [in] The MDD context handle for the touch screen.

Return Value

Returns the PDD context handle for the touch screen on success. NULL indicates failure.

Remarks

The Compact 2013 MDD calls this function when its own Init function is called. For more information on the Init function of a stream driver, see XXX_Init (Device Manager).

The MDD must call this function before calling other PDD functions. When the MDD calls other PDD functions, it passes the PDD context handle that this function returns.

When the PDD calls the callback function to pass touch contact data, it also passes back the MDD context handle received as parameter hMddContext. See PFN_TCH_MDD_REPORTSAMPLESET for information about the callback function.

Requirements

Header

tchstreamddsi.h

See Also

Reference

Touch Driver DDSI Functions