USBCAMD_ControlVendorCommand-Funktion (usbcamdi.h)
Die USBCAMD_ControlVendorCommand-Funktion sendet anbieterspezifische Befehle an die Steuerpipe.
Syntax
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
);
Parameter
[in] DeviceContext
Zeiger auf den gerätespezifischen Kontext.
[in] Request
Gibt den Wert des Felds Anforderung für den Vendor-Befehl an.
[in] Value
Gibt den Wert des Felds Wert für den Vendor-Befehl an.
[in] Index
Gibt den Wert des Felds Index für den Vendor-Befehl an.
[in, out, optional] Buffer
Zeiger auf einen Datenpuffer, wenn der Befehl Über Daten verfügt. Wenn der Befehl keine Daten enthält, ist dieser Wert NULL.
[in, out] BufferLength
Zeiger auf den Wert der Pufferlänge. Die Pufferlänge wird in Bytes ausgedrückt. Wenn der Wert von BufferNULL ist, kann BufferLength auch NULL sein.
[in] GetData
GetData gibt an, dass Daten vom Gerät an den Host gesendet wurden.
[in, optional] CommandComplete
Zeiger auf einen von der Kamera minidriver definierten BefehlCompleteFunction, der aufgerufen wird, wenn das Massenlese- oder Schreibvorgang abgeschlossen ist. Dieser Wert kann NULL sein.
[in, optional] CommandContext
Zeiger auf einen Speicherblock, der als Argument an den kameraminidriver definierten CommandCompleteFunction übergeben wird.
Rückgabewert
USBCAMD_ControlVendorCommand gibt den NTSTATUS-Code vom Befehl vendor zurück.
Weitere mögliche Fehlercodes sind:
Rückgabecode | Beschreibung |
---|---|
STATUS_PENDING | Der Vendor-Befehl wird zurückgestellt. |
STATUS_INSUFFICIENT_RESOURCES | Es sind nicht genügend Ressourcen vorhanden, um den Vendor-Befehl zuzuordnen. |
Hinweise
Diese Funktion kann unter IRQL >= PASSIVE_LEVEL aufgerufen werden. Wenn die Funktion unter IRQL > PASSIVE_LEVEL aufgerufen wird, wird der Befehl verzögert. Nach Abschluss wird der von der Kamera minidriver definierte CommandCompleteFunction aufgerufen und der Wert im Argument CommandContext * übergeben.*
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Desktop |
Kopfzeile | usbcamdi.h (einschließlich Usbcamdi.h) |
Bibliothek | Usbcamd2.lib |
IRQL | Größer als oder gleich PASSIVE_LEVEL (siehe Abschnitt "Hinweise") |