Metodo IPort::GetDeviceProperty (portcls.h)
Il metodo GetDeviceProperty fornisce un accesso semplificato alle proprietà del dispositivo contenute nel Registro di sistema per i dispositivi Plug and Play.
Sintassi
NTSTATUS GetDeviceProperty(
DEVICE_REGISTRY_PROPERTY DeviceProperty,
ULONG BufferLength,
PVOID PropertyBuffer,
PULONG ResultLength
);
Parametri
DeviceProperty
Identifica la particolare proprietà del dispositivo richiesta dal chiamante. I valori validi per questo parametro sono uguali a quelli definiti per il parametro DeviceProperty della chiamata IoGetDeviceProperty.
BufferLength
Specifica la lunghezza in byte del buffer che deve ricevere le informazioni richieste.
PropertyBuffer
Puntatore al buffer delle proprietà. Questo parametro punta a un buffer allocato dal chiamante in cui il metodo scrive le informazioni sulle proprietà richieste. Il buffer deve essere sufficientemente grande da contenere il numero di byte specificato in BufferLength.
ResultLength
Puntatore di output alla lunghezza dei dati restituiti. Questo parametro punta a una variabile ULONG allocata dal chiamante in cui il metodo scrive un conteggio specificando il numero di byte effettivamente scritti nel buffer PropertyBuffer. Se il buffer è troppo piccolo per contenere le informazioni, tuttavia, il metodo restituisce invece le dimensioni del buffer necessarie.
Valore restituito
Questo metodo restituisce NTSTATUS che contiene STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato. Se il buffer delle proprietà fornito dal chiamante è troppo piccolo, il metodo restituirà STATUS_BUFFER_TOO_SMALL e restituirà le dimensioni necessarie in ReturnLength.
Osservazioni
Questo metodo recupera le proprietà del dispositivo dell'adattatore audio. È simile al funzionamento della funzione PcGetDeviceProperty, ad eccezione del fatto che recupera automaticamente le proprietà del dispositivo della scheda audio anziché richiedere a un oggetto dispositivo di specificare in modo esplicito un dispositivo di destinazione.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | portcls.h |
| IRQL | PASSIVE_LEVEL |