xxx_IOControl (Services.exe) (Windows Embedded CE 6.0)

1/6/2010

This function is used to send a control code to a service.

Syntax

BOOL xxx_IOControl(
  DWORD dwData,
  DWORD dwCode,
  PBYTE pBufIn,
  DWORD dwLenIn,
  PBYTE pBufOut,
  DWORD dwLenOut,
  PDWORD pdwActualOut
);

Parameters

• dwData
  [in] Specifies the value returned by xxx_Init (Services.exe) for the given service instance.

• dwCode
  [in] Specifies the control code for the operation. This value identifies the specific operation to be performed and the type of device on which to perform it.

• pBufIn
  [in] Pointer to a buffer that contains the data required to perform the operation. This parameter can be NULL if the dwCode parameter specifies an operation that does not require data.

• dwLenIn
  [in] Specifies the size, in bytes, of the buffer pointed to by pBufIn.

• pBufOut
  [out] Pointer to a buffer that receives the output data from the operation. This parameter can be NULL if the dwCode parameter specifies an operation that does not produce output data.

• dwLenOut
  [in] Specifies the size, in bytes, of the buffer pointed to by pBufOut.

• pdwActualOut
  [out] Pointer to a variable that receives the size, in bytes, of the data stored into the buffer pointed to by pBufOut. If the output buffer is too small to return any data, then the call fails and GetLastError returns the error code ERROR_INSUFFICIENT_BUFFER, and the returned byte count is zero.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

The control code specifies the action that the driver is to perform. For example, a control code can ask a service to return information or direct the service to carry out an action. Windows Embedded CE. NET provides a number of standard control codes. In addition, a service can define its own service-specific control code. For more information, see Services.exe IOCTLS.

Services.exe uses the xxx prefix. When implementing the stream interface, replace xxx with a prefix appropriate for your specific implementation.

For more information about Services.exe and stream interface implementation, see Stream Interface Driver Implementation.

Requirements

See Also

Reference

Services.exe Functions
xxx_Init (Services.exe)
Services.exe IOCTLS