USBA_ALLOC_HCDI_OPS(9F) Kernel Functions for Drivers USBA_ALLOC_HCDI_OPS(9F)

usba_alloc_hcdi_ops, usba_free_hcdi_ops —
allocate and free USB HCD interface operations structure

#include <sys/usb/usba/hcdi.h>

usba_hcdi_ops_t *
usba_alloc_hcdi_ops(void);

void
usba_free_hcdi_ops(usba_hcdi_ops_t *ops);

Volatile - illumos USB HCD private function

This is a private function that is not part of the stable DDI. It may be removed or changed at any time.

ops
Pointer to an allocated HCD interface operations structure.

The usba_alloc_hcdi_ops() function allocates a usba_hcdi_ops_t(9S) structure for use for a USB HCD driver. As part of initialization, a USB HCD driver will allocate this and fill it in. For more information on the full lifetime of the object and when a USB HCD driver should release the structure, see usba_hcdi(9E).

The usba_free_hcdi_ops() function release the memory associated with the usba_hcdi_ops_t(9S) structure pointed to by ops. Only pointers received from a call to the usba_alloc_hcdi_ops() function should be passed to this function.

These functions are generally called from kernel context during a USB HCD driver's attach(9E) and detach(9E) entry points. While it is safe to call this function from user context, it would be quite unusal to do so.

The usba_alloc_hcdi_ops() function always succeeds and returns a pointer to an allocation operations structure.

usba_hcdi(9E), usba_hcdi_ops_t(9S)
November 26, 2017 OmniOS