funzione USBCAMD_ControlVendorCommand (usbcamdi.h)
La funzione USBCAMD_ControlVendorCommand invia comandi specifici del fornitore alla pipe del controllo.
Sintassi
NTSTATUS USBCAMD_ControlVendorCommand(
[in] PVOID DeviceContext,
[in] UCHAR Request,
[in] USHORT Value,
[in] USHORT Index,
[in, out, optional] PVOID Buffer,
[in, out] PULONG BufferLength,
[in] BOOLEAN GetData,
[in, optional] PCOMMAND_COMPLETE_FUNCTION CommandComplete,
[in, optional] PVOID CommandContext
);
Parametri
[in] DeviceContext
Puntatore al contesto specifico del dispositivo.
[in] Request
Specifica il valore del campo Request per il comando fornitore.
[in] Value
Specifica il valore del campo Valore per il comando fornitore.
[in] Index
Specifica il valore del campo Indice per il comando fornitore.
[in, out, optional] Buffer
Puntatore a un buffer di dati se il comando dispone di dati. Se il comando non dispone di dati, questo valore è NULL.
[in, out] BufferLength
Puntatore al valore di lunghezza del buffer. La lunghezza del buffer è espressa in byte. Se il valore di Buffer è NULL, BufferLength può anche essere NULL.
[in] GetData
GetData indica che i dati sono stati inviati dal dispositivo all'host.
[in, optional] CommandComplete
Puntatore a un minidriver della fotocamera definito CommandCompleteFunction, che viene chiamato quando viene completata la lettura bulk o la scrittura. Questo valore può essere NULL.
[in, optional] CommandContext
Puntatore a un blocco di memoria, passato come argomento al minidriver della fotocamera definito CommandCompleteFunction.
Valore restituito
USBCAMD_ControlVendorCommand restituisce il codice NTSTATUS dal comando fornitore.
Altri codici di errore possibili includono:
Codice restituito | Descrizione |
---|---|
STATUS_PENDING | Il comando fornitore viene posticipato. |
STATUS_INSUFFICIENT_RESOURCES | Esistono risorse insufficienti per allocare il comando fornitore. |
Commenti
Questa funzione può essere chiamata in IRQL >= PASSIVE_LEVEL. Se la funzione viene chiamata in IRQL > PASSIVE_LEVEL, il comando viene posticipato. Al termine, il minidriver della fotocamera definito CommandCompleteFunction viene chiamato e passato il valore nell'argomento CommandContext *.*
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Desktop |
Intestazione | usbcamdi.h (includere Usbcamdi.h) |
Libreria | Usbcamd2.lib |
IRQL | Maggiore o uguale a PASSIVE_LEVEL (vedere la sezione Osservazioni) |