Método IPort::GetDeviceProperty (portcls.h)
El método GetDeviceProperty proporciona acceso simplificado a las propiedades del dispositivo contenidas en el Registro para dispositivos Plug and Play.
Sintaxis
NTSTATUS GetDeviceProperty(
DEVICE_REGISTRY_PROPERTY DeviceProperty,
ULONG BufferLength,
PVOID PropertyBuffer,
PULONG ResultLength
);
Parámetros
DeviceProperty
Identifica la propiedad de dispositivo determinada que solicita el autor de la llamada. Los valores válidos para este parámetro son los mismos que los definidos para el parámetro DeviceProperty de la llamada a IoGetDeviceProperty.
BufferLength
Especifica la longitud en bytes del búfer que va a recibir la información solicitada.
PropertyBuffer
Puntero al búfer de propiedades. Este parámetro apunta a un búfer asignado por el autor de la llamada en el que el método escribe la información de propiedad solicitada. El búfer debe ser lo suficientemente grande como para contener el número de bytes especificados en BufferLength.
ResultLength
Puntero de salida a la longitud de los datos devueltos. Este parámetro apunta a una variable ULONG asignada por el autor de la llamada en la que el método escribe un recuento que especifica el número de bytes realmente escritos en el búfer PropertyBuffer. Sin embargo, si el búfer es demasiado pequeño para contener la información, el método genera el tamaño de búfer necesario.
Valor devuelto
Este método devuelve NTSTATUS que contiene STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado. Si el búfer de propiedades proporcionado por el llamador es demasiado pequeño, el método devolverá STATUS_BUFFER_TOO_SMALL y generará el tamaño necesario en ReturnLength.
Comentarios
Este método recupera las propiedades del dispositivo del adaptador de audio. Es similar en funcionamiento a la función PcGetDeviceProperty, salvo que recupera automáticamente las propiedades del dispositivo del adaptador de audio en lugar de requerir que un objeto de dispositivo especifique explícitamente un dispositivo de destino.
Requisitos
| Requisito | Valor |
|---|---|
| Header | portcls.h |
| IRQL | PASSIVE_LEVEL |