funzione HidP_UnsetUsages (hidpi.h)

La routine HidP_UnsetUsages imposta il pulsante di controllo HID specificato utilizzi OFF (zero) in un report HID.

Sintassi

NTSTATUS HidP_UnsetUsages(
  [in]           HIDP_REPORT_TYPE     ReportType,
  [in]           USAGE                UsagePage,
  [in, optional] USHORT               LinkCollection,
  [in, out]      PUSAGE               UsageList,
  [in, out]      PULONG               UsageLength,
  [in]           PHIDP_PREPARSED_DATA PreparsedData,
  [in]           PCHAR                Report,
  [in]           ULONG                ReportLength
);

Parametri

[in] ReportType

Specifica un valore enumeratore HIDP_REPORT_TYPE che indica il tipo di report disponibile in Report.

[in] UsagePage

Specifica la pagina di utilizzo degli utilizzi specificati da UsageList.

[in, optional] LinkCollection

Specifica la raccolta di collegamenti che contiene gli utilizzi. Se LinkCollection è diverso da zero, la routine imposta solo gli utilizzi, se presenti, in questa raccolta di collegamenti. Se LinkCollection è pari a zero, la routine imposta il primo utilizzo per ogni utilizzo trovato nella raccolta di primo livello associata a PreparsedData.

[in, out] UsageList

Puntatore alla matrice di utilizzi da impostare su OFF.

[in, out] UsageLength

Specifica, in base all'input, il numero di utilizzi in UsageList. Per informazioni sul valore di output, vedere la sezione Osservazioni.

[in] PreparsedData

Puntatore al prepara i dati della raccolta di livello superiore associata al report presente in Report.

[in] Report

Puntatore a un report.

[in] ReportLength

Specifica le dimensioni, in byte, del report che si trova in Report, che deve essere uguale alla lunghezza del report per il tipo di report specificato che HidP_GetCaps restituisce nella struttura HIDP_CAPS di un insieme.

Valore restituito

HidP_UnsetUsages restituisce HIDP_STATUS_SUCCESS se viene impostata correttamente su OFF tutti gli utilizzi in UsageList.

HidP_UnsetUsages restituisce uno dei valori di stato seguenti se uno dei parametri di input non è valido:

HidP_UnsetUsages restituisce uno dei valori di stato seguenti se non è stato possibile impostare su OFF uno degli utilizzi in UsageList:

Osservazioni

HidP_UnsetUsages imposta UsageLength come indicato di seguito:

Per altre informazioni, vedere raccolte HID.

Fabbisogno

Vedere anche

HidP_SetButtons

HidP_SetData

HidP_SetUsages

HidP_UnsetButtons

_HIDP_PREPARSED_DATA