BusChildIoControl (Windows Embedded CE 6.0)

1/6/2010

This function sends an I/O control code to the bus driver that is related to the caller driver.

Syntax

BOOL BusChildIoControl(
    HANDLE hBusAccess,
    DWORD dwIoControlCode,
    LPVOID lpBuffer, 
    DWORD  nBufferSize
) ;

Parameters

• hBusAccess
  [in] Handle obtained CreateBusAccessHandle.

• dwIoControlCode
  [in] IOCTL for the operation. This value identifies the specific operation to perform and the types of device on which to perform the operation. There are no specific values defined for the dwIoControlCode parameter. However, you can define custom IOCTL_XXX IOCTLs with the CTL_CODE macro. You can then advertise these IOCTLs and an application can use these IOCTLs with BusChildIoControl to perform the bus-specific functions.

• lpBuffer
  [in/out] Long pointer to a buffer that contains the data required to perform the operation. Set to NULL if the dwIoControlCode parameter specifies an operation that does not require input data.

• nBufferSize
  [in] Size, in bytes, of the buffer pointed to by lpBuffer.

Return Value

Returns TRUE if successful. Otherwise, it returns FALSE.

Remarks

When this function is called, the CEDDK appends the client driver identifier (the child bus driver name) into the input buffer before it calls DeviceIoControl internally.

Requirements

See Also

Reference

CEDDK Dynamic-Link Library Bus Access Functions
CEDDK Dynamic-Link Library Bus Access IOCTLs
CreateBusAccessHandle

Other Resources

CTL_CODE