changerGetParameters 函式 (mcd.h)
ChangerGetParameters 會 使用 IOCTL 程式代碼 IOCTL_CHANGER_GET_PARAMETERS來處理裝置控制項 IRP 的裝置特定層面。
語法
NTSTATUS ChangerGetParameters(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
參數
[in] DeviceObject
代表變更器的裝置物件的指標。
[in] Irp
IRP 的指標。
傳回值
ChangerGetParameters 會傳回系統埠驅動程式或下列其中一個值所傳回的 STATUS_XXX 值:
STATUS_SUCCESS
STATUS_INFO_LENGTH_MISMATCH
STATUS_INSUFFICIENT_RESOURCES
備註
此例程是必要的。
ChangerGetParameters 會傳回變更器的參數,包括其元素的數目和類型及其支援的功能。
changer 類別驅動程式會在呼叫 ChangerGetParameters 之前,先檢查 I/O 堆棧位置中的輸出緩衝區長度。 如果輸出緩衝區長度小於 sizeof (GET_CHANGER_PARAMETERS) changer 類別驅動程式會傳回值為 STATUS_INFO_LENGTH_MISMATCH。
ChangerGetParameters 會藉由使用 CDB 建置 SDB 來取得 SCSI 參數標頭頁面、元素地址頁面、傳輸幾何頁面和裝置功能頁面,或與此數據相等的非 SCSI 對等專案,以從裝置擷取參數數據。
ChangerGetParameters 接著會在 Irp-AssociatedIrp.SystemBuffer> 填入GET_CHANGER_PARAMETERS結構,然後再返回 changer 類別驅動程式。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | mcd.h (包括 Mcd.h、Ntddchgr.h) |
IRQL | PASSIVE_LEVEL |