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 建置 SRB 來取得 SCSI 參數標頭頁面、元素地址頁、傳輸幾何頁面和裝置功能頁面,或與此數據相等的非 SCSI,以從裝置擷取參數數據。
ChangerGetParameters 然後在 Irp->AssociatedIrp.SystemBuffer 填入GET_CHANGER_PARAMETERS結構,再返回變更器類別驅動程式。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | mcd.h (包括 Mcd.h、 Ntddchgr.h) |
IRQL | PASSIVE_LEVEL |