REQUEST_GET_LOCAL_HOST_INFO control code

The REQUEST_GET_LOCAL_HOST_INFO request returns information about the local node's host controller.

The relevant members of the IRB for this request are:


typedef struct _IRB {
  ULONG FunctionNumber;
    .
    .
    .
  union {
    struct {
      ULONG    nLevel;
      PVOID    Information;
    } GetLocalHostInformation;
    .
    .
    .
  } u;
} IRB;

IRB Input

FunctionNumber

REQUEST_GET_LOCAL_HOST_INFO

u.GetLocalHostInformation.nLevel

Specifies what level of information is desired from this call. The following flags are provided.

FlagDescription

GET_HOST_UNIQUE_ID

Requests the port driver to return the 64-bit unique identifier.

GET_HOST_CAPABILITIES

Requests the port driver to return the host controller's capability flags.

GET_HOST_DDI_VERSION

Requests the DDI version of the 1394 bus driver.

GET_POWER_SUPPLIED

Requests the port driver to return the power characteristics of the bus.

GET_PHYS_ADDR_ROUTINE

Requests the port driver to return the host controller's physical address mapping function.

GET_HOST_CONFIG_ROM

Requests the port driver to return the host controller's configuration ROM.

GET_HOST_CSR_CONTENTS

Requests the port driver to return the speed or topology maps from the host controller's CSR. See the IEEE 1394 Specification for a description of CSRs.

Note  In Windows 7, setting nLevel to GET_HOST_CSR_CONTENTS and specifying the SPEED_MAP_LOCATION as CsrBaseAddress is not supported. The speed map is obsolete in the IEEE-1394a specification.

GET_HOST_DMA_CAPABILITIES

Requests the port driver to return the host controller's capability flags and the size of the DMA buffer (PAGESIZE multiplied by the number of mapping registers).

 

u.GetLocalHostInformation.Information

Points to an information block to be filled in, depending on what level of information is desired. Each block has its own particular structure.

FlagStructure

GET_HOST_UNIQUE_ID

GET_LOCAL_HOST_INFO1

GET_HOST_CAPABILITIES

GET_LOCAL_HOST_INFO2

GET_POWER_SUPPLIED

GET_LOCAL_HOST_INFO3

GET_PHYS_ADDR_ROUTINE

GET_LOCAL_HOST_INFO4

GET_HOST_CONFIG_ROM

GET_LOCAL_HOST_INFO5

GET_HOST_CSR_CONTENTS

GET_LOCAL_HOST_INFO6

GET_HOST_DMA_CAPABILITIES

GET_LOCAL_HOST_INFO7

GET_HOST_DDI_VERSION

GET_LOCAL_HOST_INFO8

 

IRB Output

u.GetLocalHostInformation.Information

Points to the information block, with the requested information filled in.

I/O Status Block

The bus driver sets Irp->IoStatus.Status to STATUS_SUCCESS on success, or the appropriate error code on failure.

See Also

IOCTL_IEEE1394_API_REQUEST

Requirements

Header

1394.h (include 1394.h)

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft