Stuurprogrammaondersteuning voor Camera UVC Control Cache

UVC-besturingselementen blijven op een apparaat hangen wanneer de frameserver wordt afgesloten. Als er een app wordt gebruikt waarmee White Balance met UVC-besturingselementen wordt ingesteld en vervolgens de app wordt afgesloten, wordt de witbalans van de camera niet opnieuw ingesteld. Andere apps die de white balance openen en niet wijzigen, nemen de vorige instelling over.

Een uitzondering hierop is wanneer de computer naar S3 gaat. Afhankelijk van of het cameraapparaat in D3 of D3 Cold gaat, kunnen de UVC-controllers wel of niet behouden blijven. Dit gedrag komt doordat D3 Cold de stroom van de camera verwijdert.

Het gebruik van het Cache UVC Control Protocol is een manier om consistent gedrag te hebben voor toepassingssessies, S3 en computeruitschakelingen.

Door de configuratiesleutel 'CacheUVCControl' in te stellen op de DWORD-waarde 1 in de HW-registersleutel van het apparaat via MS OS 2.0-descriptors of de oudere methode van aangepast INF-bestand, behoudt een camera UVC-besturingswaarden die door de gebruiker zijn ingesteld bij het opnieuw opstarten van S3 of de computer. De lijst met specifieke UVC-besturingswaarden die worden opgeslagen en opnieuw worden toegepast, vindt u hieronder.

Betrokken UVC-besturingselementen

Hieronder ziet u een lijst met UVC-besturingselementen die in de cache worden opgeslagen en opnieuw worden toegepast bij opnieuw opstarten:

• KSPROPERTY_VIDEOPROCAMP_BRIGHTNESS
• KSPROPERTY_VIDEOPROCAMP_CONTRAST
• KSPROPERTY_VIDEOPROCAMP_GAIN
• KSPROPERTY_VIDEOPROCAMP_GAMMA
• KSPROPERTY_VIDEOPROCAMP_HUE(+ AUTO)
• KSPROPERTY_VIDEOPROCAMP_SATURATION
• KSPROPERTY_VIDEOPROCAMP_SHARPNESS
• KSPROPERTY_VIDEOPROCAMP_WHITEBALANCE(+ AUTO)

INF-voorbeeld

[Device.AddReg.HW]
HKR,,"CacheUVCControl",0x00010001,1

MS OS 2.0 Descriptor-voorbeeld

UCHAR Example_MSOS20DescriptorSet_CacheUVCControl[0x38] =
{
    //
    // Microsoft OS 2.0 Descriptor Set Header
    //
    0x0A, 0x00,               // wLength - 10 bytes
    0x00, 0x00,               // MSOS20_SET_HEADER_DESCRIPTOR
    0x00, 0x00, 0x0?, 0x06,   // dwWindowsVersion – 0x060?0000 for future Windows version
    0x3C, 0x00,               // wTotalLength – 60 bytes

    //
    // Microsoft OS 2.0 Registry Value Feature Descriptor
    //
    0x32, 0x00,               // wLength 0x32 (50) in bytes of this descriptor  
    0x04, 0x00,               // wDescriptorType – MSOS20_FEATURE_REG_PROPERTY  
    0x04, 0x00,               // wPropertyDataType - REG_DWORD  
    0x24, 0x00,               // wPropertyNameLength – 0x24 (36) bytes
    'C',  0x00, 'a',  0x00,   // Property Name - “CacheUVCControl”  
    'c',  0x00, 'h',  0x00,  
    'e',  0x00, 'U',  0x00,
    'V',  0x00, 'C',  0x00,  
    'C',  0x00, 'o',  0x00,  
    'n',  0x00, 't',  0x00,  
    'r',  0x00, 'o',  0x00,  
    'l',  0x00, 0x00, 0x00,
    0x00, 0x00, 0x00, 0x00,
    0x04, 0x00,               // wPropertyDataLength – 4 bytes  
    0x01, 0x00, 0x00, 0x00,   // Enable to cache UVC controls  
}