estructura _URB_CONTROL_GET_STATUS_REQUEST (usb.h)
Los controladores de cliente USB usan la estructura _URB_CONTROL_GET_STATUS_REQUEST para recuperar el estado de un dispositivo, una interfaz, un punto de conexión u otro destino definido por el dispositivo.
Sintaxis
struct _URB_CONTROL_GET_STATUS_REQUEST {
struct _URB_HEADER Hdr;
PVOID Reserved;
ULONG Reserved0;
ULONG TransferBufferLength;
PVOID TransferBuffer;
PMDL TransferBufferMDL;
struct _URB *UrbLink;
struct _URB_HCD_AREA hca;
UCHAR Reserved1[4];
USHORT Index;
USHORT Reserved2;
};
Miembros
Hdr
Puntero a una estructura de _URB_HEADER que especifica la información del encabezado URB. Hdr.Length debe ser sizeof(_URB_CONTROL_GET_STATUS_REQUEST)
, y Hdr.Function debe ser uno de los siguientes valores:
- URB_FUNCTION_GET_STATUS_FROM_DEVICE
- URB_FUNCTION_GET_STATUS_FROM_INTERFACE
- URB_FUNCTION_GET_STATUS_FROM_ENDPOINT
- URB_FUNCTION_GET_STATUS_FROM_OTHER
Reserved
Reservado. No utilizar.
Reserved0
Reservado. No utilizar.
TransferBufferLength
Debe ser 2. Este miembro especifica la longitud, en bytes, del búfer especificado en TransferBuffer o descrito en TransferBufferMDL. El controlador del controlador de host devuelve el número de bytes enviados o leídos desde la canalización de este miembro.
TransferBuffer
Puntero a un búfer residente para la transferencia o es NULL si se proporciona una MDL en TransferBufferMDL. El controlador de bus devuelve un solo byte que especifica el estado del destino.
TransferBufferMDL
Puntero a una MDL que describe un búfer residente o es NULL si se proporciona un búfer en TransferBuffer. El controlador de bus devuelve un solo byte que especifica el estado del destino. Este MDL debe asignarse desde un grupo no paginado.
UrbLink
Reservado. No utilizar.
hca
Reservado. No utilizar.
Reserved1[4]
Reservado. No utilizar.
Index
Especifica el índice definido por el dispositivo, devuelto por una solicitud de configuración correcta, si la solicitud es para un punto de conexión o interfaz. De lo contrario, Index debe ser cero.
Reserved2
Reservado. No utilizar.
Comentarios
Los controladores pueden usar la rutina de servicio UsbBuildGetStatusRequest para dar formato a este URB.
Los miembros reservados de esta estructura deben tratarse como opacos y están reservados para uso del sistema.
Requisitos
Requisito | Valor |
---|---|
Header | usb.h (incluya Usb.h) |