Metodo IPort::GetDeviceProperty (portcls.h)

Il metodo GetDeviceProperty consente l'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 gli stessi 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 specificati 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 che specifica il numero di byte effettivamente scritti nel buffer PropertyBuffer. Se il buffer è troppo piccolo per contenere le informazioni, 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 della proprietà fornito dal chiamante è troppo piccolo, il metodo restituirà STATUS_BUFFER_TOO_SMALL e restituirà le dimensioni necessarie in ReturnLength.

Commenti

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.

Requisiti

Requisito	Valore
Intestazione	portcls.h
IRQL	PASSIVE_LEVEL

Vedi anche

IPort