共用方式為

IPort：：GetDeviceProperty 方法 (portcls.h)

  • 發行項

GetDeviceProperty 方法提供裝置屬性的簡化存取，這些屬性包含在 隨插即用 裝置的登錄中。

語法

NTSTATUS GetDeviceProperty(
  DEVICE_REGISTRY_PROPERTY DeviceProperty,
  ULONG                    BufferLength,
  PVOID                    PropertyBuffer,
  PULONG                   ResultLength
);

參數

DeviceProperty

識別呼叫端所要求的特定裝置屬性。 此參數的有效值與針對IoGetDeviceProperty呼叫的DeviceProperty參數所定義的值相同。

BufferLength

指定緩衝區的長度，以位元組為單位來接收要求的資訊。

PropertyBuffer

屬性緩衝區的指標。 此參數指向呼叫端配置的緩衝區，該方法會將要求的屬性資訊寫入其中。 緩衝區必須夠大，才能包含 BufferLength 中指定的位元元組數目。

ResultLength

傳回數據的長度輸出指標。 這個參數指向呼叫端配置的 ULONG 變數，該方法會將計數寫入其中，以指定實際寫入 PropertyBuffer 緩衝區的位元元組數目。 不過，如果緩衝區太小而無法包含資訊，方法會改為輸出所需的緩衝區大小。

傳回值

如果呼叫成功，這個方法會傳回NTSTATUS，其中包含STATUS_SUCCESS。 否則，方法會傳回適當的錯誤碼。 如果呼叫端所提供的屬性緩衝區太小，方法會傳回STATUS_BUFFER_TOO_SMALL，並在 ReturnLength 中輸出所需的大小。

備註

這個方法會擷取音訊配接器的裝置屬性。 其運作方式類似於PcGetDeviceProperty函式，不同之處在於它會自動擷取音頻配接器的裝置屬性，而不需要裝置對象明確指定目標裝置。

規格需求

需求 值
標頭 portcls.h
IRQL PASSIVE_LEVEL

另請參閱

IPort